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#
- Open Webhooks in your workspace and add an endpoint URL.
- Choose the events to receive.
- Copy the signing secret (
whsec_…). It's shown once; you can rotate it later. - Click Send test event to deliver a
pingand 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.
{
"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. workspaceobjectrequiredidandslugof the workspace.dataobjectrequired- Event-specific data. See event types.
Headers#
Intrio-Event-Idstring- Same as
id. Intrio-Event-Typestring- Same as
type. Intrio-Signaturestringt=<unix seconds>,v1=<hex>. See signatures.User-AgentstringIntrio-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.