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

PartnerStack (BYOK) — connector documentation

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

What PartnerStack (BYOK) is for

PartnerStack (BYOK) lets an AI assistant read your own PartnerStack data through the PartnerStack API with a key you supply (PartnerStack public key (vendor API)). Read-only: 11 tools (list_partnerships, get_partnership, list_customers, list_transactions, list_rewards, list_actions, list_leads, list_deals, list_groups, list_applications, list_partnership_links). 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 api.partnerstack.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by PartnerStack. PartnerStack 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 partners joined my PartnerStack program recently?"
  • "Show the details of PartnerStack partnership co_a80cb515fe"
  • "Which customers did partner pp_1234 refer?"
  • "What transactions were recorded for customer cus_abc123?"
  • "What rewards are pending for PartnerStack partner co_a80cb515fe?"
  • "Which partner actions were recorded this month?"

What it does

  • list_partnerships: List the partners in your program, newest first, filtered by approval status, group, email or dates; each entry shows the partner, group and status.
  • get_partnership: Get one partnership by its partnership key, with partner details, group, tags and status.
  • list_customers: List customers your partners referred, newest first, optionally for one partner or partnership, with the partner each belongs to.
  • list_transactions: List the revenue transactions recorded for referred customers with amount in cents, currency and customer, newest first.
  • list_rewards: List partner rewards (commissions) with amount, status, partner and customer, by status, partner, group or creation date.
  • list_actions: List recorded partner actions such as sign-ups or trials, with the partnership and customer involved, newest first.
  • list_leads: List leads partners submitted to your program with lead details and partner, newest first.
  • list_deals: List deals registered by partners with stage and partner details, newest first.
  • list_groups: List your partner groups (the segments with their own rewards and rules).
  • list_applications: List applications to join your program by status (pending, approved, declined, flagged), applicant email or date.
  • list_partnership_links: List the referral links of one partnership.

BYOK key

You bring your own PartnerStack PartnerStack public key (vendor API) (https://app.partnerstack.com/settings/integrations). 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 api.partnerstack.com 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 PartnerStack API (api.partnerstack.com) with a BYOK key; documentation: https://docs.partnerstack.com/docs/partnerstack-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 PartnerStack. PartnerStack 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 PartnerStack account.

Built for: Worldwide. Languages: English.