Skip to main content
WEBHOOK
Use this page to review the generated payload schema for webhook deliveries.

Body

application/json

Payload Heymarket posts to configured webhook URLs.

type
enum<string>
required

Heymarket webhook event type. message_recieved preserves the current API spelling. message_failed is sent when an outbound message fails, either at send time or when the carrier reports a delivery failure; its payload carries status and raw_error. private_comment_created is sent when a private comment is created in the Heymarket app or through the public API with private set to true, only to webhooks with "Include private comments" enabled (off by default). Its payload is a Message with type memo (or group:memo for group conversations), user set to the creator, and author when one was supplied. Private comments added by AI agents or the Help Scout integration do not send this event.

Available options:
message_sent,
message_recieved,
message_failed,
chat_reassigned,
chat_closed,
chat_opened,
chat_pending,
chat_transferred,
target_opt_out,
target_opt_in,
target_double_opt_in,
target_double_opt_restricted,
incoming_call,
private_comment_created
id
string<uuid>
required

Unique ID of this event. Every webhook that receives the same event gets the same ID.

token
string
required

Webhook verification token generated for the webhook configuration.

event_data
object
required

Event payload. Message events send a Message, chat events send a Conversation, and opt-in/opt-out events send an UnSubscribed payload.

Response

Webhook event accepted.