Fidel API
for LuumenAI
Read Fidel API programs, offers, and cards, then make changes as approved steps
Connect Fidel API and Luumen can answer questions about your card-linking setup without you opening the dashboard: which programs exist, which locations sit under a brand, which cards activated an offer, what a given transaction looked like. Changes — new offers, locations, webhooks, MID requests — are previewed and sent for approval first. Luumen authenticates with an API key.
The Fidel API toolbox
39 tools: 22 read, 17 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadGet BrandRetrieve information about a specific brand.
- ReadGet LocationRetrieve details of a specific location by its ID.
- ReadGet MIDRetrieve details of a specific MID (Merchant ID).
- ReadGet MID RequestRetrieve details of a specific MID request.
- ReadGet OfferRetrieves detailed information about a specific offer by its unique ID.
- ReadGet ProgramRetrieve details of a specific program.
- ReadGet TransactionRetrieve details of a specific transaction by its ID.
- ReadGet WebhookRetrieve details of a specific webhook by its unique identifier.
- ReadList BrandsRetrieves a paginated list of all brands associated with your Fidel API account.
- ReadList CardsList all payment cards linked to a Fidel program.
- ReadList Cards By MetadataList payment cards filtered by metadata ID.
- ReadList Cards with Active OfferList all payment cards that have activated a specific offer.
- ReadList LocationsList all locations for a program.
- ReadList Locations by BrandList all locations for a specific brand within a program.
- ReadList Locations by OfferList all locations linked to a specific offer.
- ReadList MID RequestsList all MID (Merchant ID) requests for a specific program.
- ReadList MIDsList all MIDs (Merchant IDs) for a program.
- ReadList Missing Transaction RequestsList all missing transaction requests for a specific program.
- ReadList OffersList all offers in the Fidel API.
- ReadList ProgramsList all Fidel programs in your account.
- ReadList Program WebhooksList all registered webhooks for a specific program.
- ReadList TransactionsList transactions for a Fidel program with optional filtering and pagination.
- WriteCreate BrandCreate a new brand in Fidel API. Approval by default
- WriteCreate Brand WebhookCreate a webhook at the brand level for receiving real-time event notifications. Approval by default
- WriteCreate LocationCreate a new location for a program in Fidel API. Approval by default
- WriteCreate MID RequestCreate a new MID (Merchant ID) request for a specific program and location. Approval by default
- WriteCreate OfferCreate a new offer in Fidel API. Approval by default
- WriteCreate ProgramCreates a new card-linked loyalty program in Fidel. Approval by default
- WriteCreate Program WebhookRegister a new webhook for program-related events. Approval by default
- WriteDelete LocationDelete a location by its ID. Approval by default
- WriteDelete OfferDelete a specified offer by its ID. Approval by default
- WriteDelete Program WebhookPermanently deletes a webhook by its ID. Approval by default
- WriteLink All Program Locations to OfferLink all brand locations in a program to an offer. Approval by default
- WriteLink Location to OfferLink a location to an offer in Fidel API. Approval by default
- WriteUnlink Location From OfferUnlink a location from an offer by removing the location association. Approval by default
- WriteUpdate BrandUpdate an existing brand's details in Fidel API. Approval by default
- WriteUpdate OfferUpdates specific properties of an existing offer. Approval by default
- WriteUpdate ProgramUpdates a Fidel API program's properties. Approval by default
- WriteUpdate WebhookUpdate an existing webhook's configuration. Approval by default
One prompt, start to finish
What a governed Fidel API run looks like inside Luumen.
Questions
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Read actions answer immediately. Anything that writes — create brand, create brand webhook, create location, create mid request, and more — is shown as a plan and requires approval by default, including the 4 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Every call to Fidel API — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
GitHubRepos, actions, and runbook code as context and as actions.
GitLabMerge requests and pipelines proposed, triggered, and rolled back.
BitbucketRead commits, diffs, and branches in Bitbucket, then open the fix as a held write.
Azure DevOpsAzure DevOps repos and pipelines as context — and as approved actions.Put Fidel API to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.