Webhooks overview

A webhook is an HTTPS POST ReachHunt sends to your server when something changes: a lead replies, a campaign finishes, a tag is added.

Add a webhook

Open webhooks

In ReachHunt, open Settings → Webhooks and select Add webhook.

Set it up

Enter a name and your https:// URL, and pick the events it receives. Add a secret header so your server can check each request.

Test it

Open the webhook’s menu and select Send test event.

A workspace can have up to 10 webhooks, and you need full access to every section of the workspace to manage them.

The event

Every event has the same envelope:

{
  "id": "evt_9f1c3b7a-2d4e-4c6a-8b1f-0e3d5c7a9b21",
  "type": "tag.created",
  "apiVersion": "1",
  "createdAt": "2026-10-19T10:32:00.000Z",
  "workspaceId": "c2a9e1f4-7b3d-4e8a-9f1c-5d6e7a8b9c01",
  "data": {
    "tag": {
      "id": "0c9e7a52-4d1b-4f3e-8a6c-2b5d9e1f7a30",
      "name": "Hot lead",
      "color": "#f97316"
    }
  }
}

Field	Notes
`id`	Unique per event. Every webhook that gets it sees the same `id`, and retries keep it. Deduplicate on it
`type`	`resource.action`, such as `message.received`
`apiVersion`	The payload version, now `1`
`createdAt`	When it happened
`workspaceId`	Your workspace
`data`	What happened. Each event type has its own fields

Headers

Header	Value
`Content-Type`	`application/json`
`User-Agent`	`ReachHunt-Webhooks/1.0`
`X-ReachHunt-Event`	The event type
`X-ReachHunt-Delivery`	The delivery ID. Retries keep it

Every request also carries the headers you added to the webhook.

ReachHunt does not sign requests. Add a secret header to the webhook and reject any request without it, see Receiving webhooks.

Event types

Resource	Events	`data`
Message	`message.received`, `message.sent`	`{ account, contact, message, sentBy }`
	`message.seen`	`{ account, contact, message, sentBy, seenAt }`
	`message.edited`	`{ account, contact, message, previousText }`
	`message.deleted`	`{ account, contact, message }`
	`message.reaction_added`, `message.reaction_removed`	`{ account, contact, message, reaction }`
Conversation	`conversation.created`, `conversation.deleted`, `conversation.archived`, `conversation.unarchived`	`{ account, conversation, contact }`
Lead	`lead.added_to_list`	`{ list, lead }`
	`lead.status_changed`	`{ lead, previousStatus, status }`
	`lead.tag_added`, `lead.tag_removed`	`{ lead, tag }`
	`lead.note_changed`	`{ lead, note }`
	`lead.valuation_changed`	`{ lead, previousValuation, valuation }`
	`lead.assignee_changed`	`{ lead, previousAssignee, assignee }`
Campaign	`campaign.created`, `campaign.started`, `campaign.paused`, `campaign.resumed`, `campaign.completed`, `campaign.stopped`	`{ campaign }`
Campaign lead	`campaign.lead_contacted`, `campaign.follow_up_sent`	`{ campaign, account, lead, messagesSent, stepType }`
	`campaign.lead_replied`	`{ campaign, account, lead, repliedAt }`
	`campaign.lead_failed`	`{ campaign, account, lead, stepType, error }`
	`connection_request.sent`	`{ campaign, account, lead, withNote }`
	`connection_request.accepted`, `connection_request.withdrawn`	`{ campaign, account, lead }`
Account	`account.connected`	`{ account }`
	`account.disconnected`	`{ account, reason, detail }`
Import	`import.completed`, `import.paused`, `import.failed`	`{ import }`
Tag	`tag.created`, `tag.updated`, `tag.deleted`	`{ tag }`
Status	`status.created`, `status.updated`, `status.deleted`	`{ status }`

Each event type has its own page under Event types with its full schema.

New event types are not added to existing webhooks. Edit a webhook to start receiving them.
Payloads follow the API’s conventions: camelCase names, timestamps in ISO 8601 UTC, and null for a value that does not apply.
New event types and data fields can be added within version 1. Ignore what you don’t know.

Limits

Up to 10 webhooks in a workspace.
Up to 5 custom headers on a webhook.
The URL must start with https://, point to a public address, and be at most 2048 characters.
Your server has 10 seconds to answer.

Receiving webhooks

Answer deliveries, check they came from ReachHunt, and handle retries.

Getting started

Webhooks

Reference

Event types

API reference

Add a webhook

The event

Headers

Event types

Limits

Receiving webhooks

​Add a webhook

​The event

​Headers

​Event types

​Limits

Receiving webhooks

Add a webhook

The event

Headers

Event types

Limits