Register a new webhook to receive real-time notifications for specific events.

Important Notes:

• Up to 50 webhooks per event per system identifier
• URLs must use HTTPS for security
• A secret key is automatically generated for signature verification
• The secret key (secret_key) is only returned once during creation - store it securely

Webhook Security:
Each webhook delivery includes an X-Webhook-Signature header whose value is sha256= followed by the
hex HMAC-SHA256 of the raw request body, keyed with the secret key string as returned. Verify it like this:

signature = "sha256=" + OpenSSL::HMAC.hexdigest("SHA256", secret_key, request.raw_post)
valid = Rack::Utils.secure_compare(signature, request.headers["X-Webhook-Signature"].to_s)

Event Selection:
Choose one or more events from the available event types. See the /webhooks/events endpoint
for the complete list of available events.

Example:

{
  "webhook": {
    "name": "Contact Sync Webhook",
    "url": "https://your-app.com/webhooks/crm-events",
    "events": ["peopleCreated", "peopleUpdated", "peopleStageUpdated"]
  }
}

Webhook Payload Format:
All webhooks receive payloads in this format:

{
  "eventId": "uuid",
  "eventCreated": "2025-10-16T12:00:00Z",
  "event": "peopleCreated",
  "resourceIds": ["person-uuid"],
  "uri": "https://api.suresendcrm.com/api/partner/people/person-uuid",
  "data": { ... event-specific data ... }
}

Delivery, retry and failure rules are described under "Handling Webhook Failures" in the API overview.