How It Works
Integration model

How it works

One Secret API Key. Two integration directions. No platform-specific concepts in the API itself - use any language, framework, or automation tool.

Your systems
  • Custom SaaS / backend
  • Internal tools
  • Data warehouse
  • Any HTTPS endpoint
Inbound REST POST contacts + tags
Outbound webhooks POST JSON events
Funnels.cm
  • Checkout & payments
  • Forms & funnels
  • Calendars
  • Contacts, tags & automations
1

Get your Secret API Key

Settings → Integration → API. One key per account, all scopes included.

2

Register webhooks (outbound)

In Settings → Integration → API → Custom Webhooks: paste your URL, pick events, and use Exact scope to limit which checkouts, forms, or calendars fire (e.g. only your Pro checkout).

3

Push contacts (inbound)

POST https://api.funnels.cm/api/v1/contacts with email and tagIds or tagNames. Tags run your automations.

4

Verify signatures (optional)

Set a signing secret on webhooks. Validate X-Funnels-Signature with HMAC-SHA256.

i
Automation tools (Zapier, Make, n8n)

Use the same webhooks and REST endpoints. Platform-specific setup lives in the Funnels.cm app under Settings → Integration - not in this API reference.