Guides

Webhooks

Get notified when relationships change — a contact goes cold, a commitment comes due, a signal fires.

Register an endpoint

POST/v1/webhooks

json

{
  "url": "https://your-app.com/hooks/n7fora",
  "events": ["contact.cooling", "commitment.due", "signal.detected"]
}

Events

contact.createdA new contact was captured or imported

contact.coolingA valuable relationship crossed its cadence window

commitment.dueA promise (yours or theirs) is coming due

signal.detectedA life or company event was detected for a contact

draft.confirmedA gated action was approved and executed

Payload

json

{
  "id": "evt_abc123",
  "type": "contact.cooling",
  "created": "2026-07-15T12:00:00Z",
  "data": { "contact_id": "ctc_sena_tan", "days_since_touch": 92 }
}

Verifying signatures

Every delivery is signed with your webhook secret in the N7FORA-Signature header. Compute an HMAC-SHA256 of the raw body with your secret and compare — reject anything that doesn't match.

Respond with a 2xx within 5 seconds. Failed deliveries are retried with exponential backoff for up to 24 hours.