Reference

01Field mapping reference

Form fields → contact

contactField Stored on contact
builtin:email email
builtin:firstName firstName
builtin:lastName lastName
builtin:fullName Split into first/last
builtin:phone phone
custom:{id} customFields[id]

Scheduling & checkout

Calendar questions use the same contactField values. Checkout webhooks include customer.email and linked contact.

02Quick reference

  • Auth: Authorization: Bearer <token> from Settings → Integration → API
  • Base: https://api.funnels.cm
  • Upsert contact: POST /api/v1/contacts - { "email", "tagNames"? | "tagIds"? }
  • Tag by email: POST /api/v1/contacts/tags - { "email", "tagIds" | "tagNames", "action": "add" }
  • List tags: GET /api/v1/tags - copy id or name for inbound requests
  • CRM leads: POST /api/v1/crms/:crmId/leads · PATCH .../leads/:leadId
  • CRM pipelines: configure on a tag; send tagIds or tagNames via contacts API
  • SaaS activation: GET /api/v1/checkout/activations/:token · POST .../complete
  • SaaS plan changes: no change-plan API — map tiers on checkout.purchased (product.id + pricing.tierIndex); cancel old sub + rebuy for upgrades/downgrades
  • Custom webhooks: 6 events; Zapier/Make have separate connection lists; verify X-Funnels-Signature if secret set
  • AI docs: GET https://api.funnels.cm/llms-full.txt