GTM Swag API
API by GTM Swag · rest
GTM Swag sends personalized physical gifts for GTM teams. Agents prepare and track; people approve and pay. Quickstart 1. Authenticate with a workspace key from Settings → Integrations: Authorization: Bearer gtm_<64 hex>. Base URL https://gtmswag.com/api/v1. A key acts as the member who created it, in one workspace. MCP OAuth access tokens (mco_access_…) work only on the gift-link distribution routes; over OAuth use MCP at https://gtmswag.com/mcp. 2. Read GET /workflow: the workspace mode, what this key may do, and the recovery rule for each error code. 3. Choose a gift with GET /catalog (public): a product with retired:false and available not false. 4. Create a playbook: POST /campaigns with mode:"always_on", status:"draft", no recipients and an idempotencyKey. A signed-in person turns it on at https://gtmswag.com/campaigns/{id}?review=1. 5. Add people once per trigger: POST /playbooks/{id}/people, then read approval.state:…
Endpoint: https://gtmswag.com/api/v1
Verification: observed. Source: crawl.
Capabilities (82)
- Upload a logo artwork or recipient portrait
- Import a recipient photo from a public URL
- Download an uploaded file
- Read the gift balance
- List balance movements newest first
- Start a balance top-up
- List campaign payments and invoices
- Cancel an unpaid checkout
- List the gifts a live checkout paid for
- Check a checkout's payment with Stripe
- Read checkout availability
- Request a refund for one prepaid gift
- List campaigns and playbooks
- Create a playbook or campaign draft
- Read a campaign
- Edit a campaign
- Turn a playbook's auto-approve on or off
- Start checkout for a reviewed batch campaign
- Read private gift links for matching
- Create a gift-link CSV export
- Upload a large source import in parts
- Keep original source columns with recipients
- Delete retained source columns
- Download one campaign's results as CSV
- Read invitation reminder settings (retired)