Skip to main content
PATCH
Update a webhook

Authorizations

X-Api-Key
string
header
required

Your secret ReachBoost API key.

Path Parameters

workspace_uuid
string<uuid>
required

Your unique workspace identifier.

Example:

"YOUR_WORKSPACE_UUID"

webhook_uuid
string<uuid>
required

The unique identifier for the webhook.

Example:

"YOUR_WEBHOOK_UUID"

Body

application/json

Every field is optional; only the fields given change.

name
string

A blank name clears it.

url
string<uri>
events
enum<string>[]

Replaces the whole list.

Available options:
connection_request_sent,
connection_request_accepted,
connection_request_withdrawn,
follow_up_message_sent,
message_replied,
message_success,
lead_finished,
lead_failed,
lead_status_not_interested,
lead_status_engaged,
lead_status_interested,
lead_status_hot_lead,
lead_status_meeting_booked,
lead_status_won,
lead_status_lost
is_active
boolean
enrichment
enum<string>[]

Replaces the whole list; an empty list switches enrichment off.

Available options:
linkedin_profile,
email,
phone

Response

Webhook updated

An outbound webhook. Custom headers, if any were set on the integrations page, are never returned.

uuid
string<uuid>
name
string | null

The name is optional, so it is null for webhooks created without one.

url
string<uri>
is_active
boolean

Only active webhooks receive deliveries.

events
enum<string>[]

The events the webhook subscribes to. At least one. Fired when: connection_request_sent a LinkedIn connection request was sent to the lead; connection_request_accepted the lead accepted the connection request; connection_request_withdrawn a pending connection request was withdrawn; follow_up_message_sent a follow-up message was sent to the lead; message_replied the lead replied to a campaign message; message_success a message was sent or received in the unified inbox; lead_finished the lead completed the campaign; lead_failed the lead stopped in the campaign with a failure; lead_status_engaged, lead_status_interested, lead_status_hot_lead, lead_status_meeting_booked, lead_status_won, lead_status_not_interested, lead_status_lost the lead's pipeline status became that status.

Available options:
connection_request_sent,
connection_request_accepted,
connection_request_withdrawn,
follow_up_message_sent,
message_replied,
message_success,
lead_finished,
lead_failed,
lead_status_not_interested,
lead_status_engaged,
lead_status_interested,
lead_status_hot_lead,
lead_status_meeting_booked,
lead_status_won,
lead_status_lost
enrichment
enum<string>[]

What each delivery enriches the lead with first. An empty list means no enrichment.

Available options:
linkedin_profile,
email,
phone
created_at
string<date-time>
updated_at
string<date-time>