Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Talon One (BYOK) — connector documentation

  • MCP endpoint: https://byok-talon-one.connectorbay.com/mcp
  • REST API: POST https://byok-talon-one.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-talon-one.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Talon One Management API key, sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-talon-one.connectorbay.com/health · Tool schemas: https://byok-talon-one.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-talon-one · agent@connectorbay.com

What Talon One (BYOK) is for

Talon One (BYOK) lets an AI assistant read your own Talon One data through the Talon One API with a key you supply (Management API key). Read-only: 12 tools (list_applications, get_application, list_campaigns, get_campaign, list_coupons, list_loyalty_programs, get_loyalty_program_statistics, list_loyalty_transactions, list_loyalty_cards, list_customer_profiles, list_application_sessions, list_audit_changes). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to *.talon.one. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Talon One. Talon One and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Which Applications exist in my Talon.One account?"
  • "Show Talon.One Application 1"
  • "Which Talon.One campaigns are running right now?"
  • "Show Talon.One campaign 10"
  • "Which coupons of Talon.One campaign 10 were redeemed?"
  • "Which loyalty programs do we run in Talon.One?"

What it does

  • list_applications: List the Applications (promotion workspaces) of the account with currency, timezone and sandbox flag.
  • get_application: Get one Application by ID with its currency, timezone, discount settings and loyalty programs.
  • list_campaigns: List the campaigns of an Application with state, schedule, tags and redemption counters. Can be filtered by state or name.
  • get_campaign: Get one campaign with state, schedule, tags, limits and redemption counters.
  • list_coupons: List the coupons of a campaign with usage counters, limits and validity dates. Cursor-less: use skip to page, hasMore tells if there is more.
  • list_loyalty_programs: List the loyalty programs of the account with tier names and join policy.
  • get_loyalty_program_statistics: Get the latest statistics of a loyalty program: active, pending, spent and expired points and member counts.
  • list_loyalty_transactions: List point transactions of a loyalty program (additions, deductions, expirations) newest first, with amount, type and rule name.
  • list_loyalty_cards: List the loyalty cards of a card-based loyalty program with status and identifier.
  • list_customer_profiles: List customer profiles known to the account with integration ID, closed session count, total sales and last activity.
  • list_application_sessions: List customer sessions (carts) of an Application with state, totals and discounts. Filter by state, profile or date.
  • list_audit_changes: List the account audit log: who changed which entity and when. Filter by user or time range.

BYOK key

You bring your own Talon One Management API key (https://docs.talon.one/docs/product/account/dev-tools/manage-mapi-keys). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to *.talon.one over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Talon One API (*.talon.one) with a BYOK key; documentation: https://docs.talon.one/management-api. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Talon One. Talon One and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Talon One account.

Built for: Worldwide. Languages: English.