Webhooks

Webhooks

Receive signed HTTP notifications when partners join, referrals change, conversions are recorded, rewards move and payouts are sent.

Available on Growth and above.

Webhooks send an HTTPS POST to your endpoint when something happens in your workspace. Use them to create CRM deals, notify your team, sync rewards to accounting or kick off onboarding.

Set up an endpoint#

  1. Open Webhooks in your workspace and add an endpoint URL.
  2. Choose the events to receive.
  3. Copy the signing secret (whsec_…). It's shown once; you can rotate it later.
  4. Click Send test event to deliver a ping and check your endpoint responds.

Payload#

Every event has the same envelope. api_version is 2026-11-20. Amounts are integers in minor units with an ISO 4217 currency. Partner bank details are never included.

JSON
{
  "id": "evt_3Jf9xQ2mZr8LkP0aT1sW",
  "type": "referral.won",
  "created_at": "2026-11-20T10:15:00.000Z",
  "api_version": "2026-11-20",
  "workspace": {
    "id": "cmws_5q8r2t",
    "slug": "acme"
  },
  "data": {
    "referral": {
      "id": "cmr_4h7d0q",
      "programme": "intro",
      "stage": "Won",
      "external_customer_id": "cus_9921",
      "company": "Acme Ltd"
    },
    "partner": {
      "id": "cmp_8f2k1x",
      "code": "jane-a1b2",
      "name": "Jane Smith",
      "company": "Smith Advisory"
    },
    "value": 1200000,
    "currency": "GBP"
  }
}
idstringrequired
Unique event id, evt_…. The same id is used for every retry. Deduplicate on it.
typestringrequired
The event type.
created_atstringrequired
When the event happened, ISO 8601 in UTC.
api_versionstringrequired
Payload version, currently 2026-11-20.
workspaceobjectrequired
id and slug of the workspace.
dataobjectrequired
Event-specific data. See event types.

Headers#

Intrio-Event-Idstring
Same as id.
Intrio-Event-Typestring
Same as type.
Intrio-Signaturestring
t=<unix seconds>,v1=<hex>. See signatures.
User-Agentstring
Intrio-Webhooks/1.0.

Responding#

Return any 2xx status within 10 seconds. Anything else, including redirects and timeouts, counts as a failure and is retried. See delivery and retries.

Last updated 20 November 2026. Building with an AI assistant? Point it at /docs/llms-full.txt.