For the complete documentation index, see llms.txt. This page is also available as Markdown.

Limitations

A few things to know when using the connector.

  • It maps to Spiffy's v2 API, so anything without a v2 endpoint isn't available as a tool.

  • It can only do what your granted accounts and scopes allow, and it never exceeds the permissions you approved when you connected.

  • Some tools refuse on plans that don't include the feature they use, with the error code plan_upgrade_required. Affiliate lead tracking, custom affiliate slugs, per-item affiliate commission overrides, advanced product pricing and non-standard billing frequencies all need the Business plan, on the connector and over the HTTP v2 API alike. See Rev 10.26.

  • Timestamps are UTC. The v2 API drops time-zone offsets in date strings, so the assistant converts local times to UTC, and filters and results come back in UTC. See Troubleshooting.

  • Tool calls share your account's monthly Spiffy API quota with your HTTP v2 usage. There's no separate connector quota, and rate limiting is per account, not per tool.

  • Orders come back without the buyer's billing and shipping address or phone number. Ask for them and the assistant fetches them with include=fields. Saved cards come back without their billing address. The buyer's IP address, browser details, order access token and tracking cookies are never returned. This applies only to the connector: the HTTP v2 API still returns the full order.

  • It never exposes raw card numbers. Cards are tokenized by Spiffy's payment processor, and the tools only ever see the token.

  • On ChatGPT, tools that make or retry a charge, refund a payment, change a saved card, or change billing terms are not available. OpenAI's platform policy does not allow assistants to facilitate payments, so those tools are withheld from the ChatGPT connector. They remain available on Claude and other MCP clients, and over the HTTP v2 API. The affected tools are noted in the Tools reference.

  • On a connection that spans several accounts, writes need an explicit account and won't default to one. That's deliberate. See Accounts and scopes.

  • Most records include a dashboard_url back to the dashboard, but a few resource types and nested records don't have one yet.

  • search_help_docs and get_help_article cover Spiffy University content only (help articles, release notes, tutorials), not your account data.

Last updated