Skip to main content

​
Webhooks

Webhook subscriptions are currently being configured. This page documents the planned webhook architecture.

​
Overview

CoreTone webhooks notify your application in real-time when events occur, such as profile updates, Tone Zone changes, or Wave delivery events.

​
Supported Events

EventDescription
profile.updatedA contact’s behavioral profile has been updated
tone_zone.changedA contact’s Tone Zone has shifted
wave.sentA Wave has been delivered
wave.openedA recipient opened a Wave
wave.repliedA recipient replied to a Wave
beacon.firedA Beacon condition has been met

​
Webhook Payload

All webhook payloads follow a consistent structure: 
{
  "event": "tone_zone.changed",
  "timestamp": "2026-04-02T14:30:00Z",
  "data": {
    "contact_id": "uuid",
    "previous_zone": "faint",
    "current_zone": "clear",
    "trigger": "email_reply"
  }
}

​
Security

Webhook payloads are signed with your webhook secret. Verify the signature before processing any webhook to prevent spoofed requests.

​
Retry Policy

Failed webhook deliveries are retried up to 10 times over 24 hours with exponential backoff.