mocop
Browse · Docs · Guide · Analyze

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)
About · Contact · Privacy