AutomateLab

SaaS webhooks / Support

Help Scout webhook events.

13 events emitted by Help Scout in the team-ops webhook catalog. Each event below carries the canonical event name, payload schema (field names and types only), auth method, signature header, retry policy, and a link back to Help Scout's docs.

Auth mix: 13 hmac-sha1 · Source extraction: 2026-05-13

All 13 events

Direct anchors. Each event header links to its own URL.

convo.agent.reply.created

An agent sends a reply from a Help Scout mailbox to a customer.

extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.agent.reply.created.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Thread ID.
type string (enum)
body string | null
Thread body text (HTML).
status string
createdAt string
openedAt string | null
createdBy object
User or customer who created this thread.
assignedTo object | null
conversationId integer required

Vendor docs

convo.assigned

A conversation is assigned to a specific Help Scout user.

extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.assigned.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Conversation ID.
number integer
Conversation number (human-readable).
subject string
status string (enum)
type string (enum)
createdAt string
closedAt string | null
userUpdatedAt string | null
customer object
The primary customer in this conversation.
assignee object | null
The assigned Help Scout user.
mailbox object
The mailbox this conversation belongs to.
tags array
Tags applied to the conversation.
threads array
Thread objects in this conversation.

Vendor docs

convo.created

A new conversation is created in a Help Scout mailbox.

extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.created.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Conversation ID.
number integer
Conversation number (human-readable).
subject string
status string (enum) required
type string (enum)
createdAt string
closedAt string | null
userUpdatedAt string | null
customer object
The primary customer in this conversation.
assignee object | null
The assigned Help Scout user.
mailbox object
The mailbox this conversation belongs to.
tags array
Tags applied to the conversation.
threads array
Thread objects in this conversation.

Vendor docs

convo.customer.reply.created

A customer sends a reply to an existing conversation.

extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.customer.reply.created.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Thread ID.
type string (enum)
body string | null
Thread body text (HTML).
status string
createdAt string
openedAt string | null
createdBy object
User or customer who created this thread.
assignedTo object | null
conversationId integer required

Vendor docs

convo.deleted

A conversation is deleted.

extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.deleted.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required

Vendor docs

convo.merged

Two conversations are merged into one.

extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.merged.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
mergedConversationId integer
ID of the conversation that was merged away.

Vendor docs

convo.moved

A conversation is moved to a different mailbox.

extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.moved.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Conversation ID.
number integer
Conversation number (human-readable).
subject string
status string (enum)
type string (enum)
createdAt string
closedAt string | null
userUpdatedAt string | null
customer object
The primary customer in this conversation.
assignee object | null
The assigned Help Scout user.
mailbox object
The mailbox this conversation belongs to.
tags array
Tags applied to the conversation.
threads array
Thread objects in this conversation.

Vendor docs

convo.note.created

An internal note is added to a conversation.

extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.note.created.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Thread ID.
type string (enum)
body string | null
Thread body text (HTML).
status string
createdAt string
openedAt string | null
createdBy object
User or customer who created this thread.
assignedTo object | null
conversationId integer required

Vendor docs

convo.status

A conversation's status changes (e.g. from active to closed).

extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.status.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Conversation ID.
number integer
Conversation number (human-readable).
subject string
status string (enum) required
type string (enum)
createdAt string
closedAt string | null
userUpdatedAt string | null
customer object
The primary customer in this conversation.
assignee object | null
The assigned Help Scout user.
mailbox object
The mailbox this conversation belongs to.
tags array
Tags applied to the conversation.
threads array
Thread objects in this conversation.

Vendor docs

convo.tags

Tags are added to or removed from a conversation.

extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: convo.tags.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Conversation ID.
number integer
Conversation number (human-readable).
subject string
status string (enum)
type string (enum)
createdAt string
closedAt string | null
userUpdatedAt string | null
customer object
The primary customer in this conversation.
assignee object | null
The assigned Help Scout user.
mailbox object
The mailbox this conversation belongs to.
tags array
Tags applied to the conversation.
threads array
Thread objects in this conversation.

Vendor docs

customer.created

A new customer record is created.

extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: customer.created.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Customer ID.
firstName string | null
lastName string | null
emails array
Array of email address objects.
phones array
Array of phone number objects.
websites array
createdAt string
updatedAt string
organization string | null
jobTitle string | null
background string | null

Vendor docs

customer.updated

A customer's profile data is updated.

extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: customer.updated.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
id integer required
Customer ID.
firstName string | null
lastName string | null
emails array
Array of email address objects.
phones array
Array of phone number objects.
websites array
createdAt string
updatedAt string
organization string | null
jobTitle string | null
background string | null

Vendor docs

satisfaction.ratings

A customer submits a satisfaction rating for a conversation.

extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha1
Signature header
X-HelpScout-Signature
Signature detail
HMAC-SHA1 of the raw request body using the webhook's secret key. The header value is base64-encoded.

Delivery

Guarantees
at-least-once
Max retry attempts
5
Backoff
Help Scout retries failed deliveries up to 5 times with increasing delays.

Payload schema (field names + types only)

eventType string required
Event type identifier: satisfaction.ratings.
createdAt string required
ISO 8601 timestamp when the event was created.
primaryKey integer required
Primary key (ID) of the affected resource.
object object
The affected resource object.
conversationId integer required
customer object
rating string (enum) required
Satisfaction rating submitted.
comments string | null
ratedAt string

Vendor docs

Use this data programmatically

The full catalog ships as a HuggingFace dataset under CC-BY-4.0. Load it with the datasets library, filter by vendor, and you have every Help Scout event in a Parquet table ready for code-generation, schema validation, or routing. 

from datasets import load_dataset
ds = load_dataset("automatelab/saas-webhook-catalog")
events = ds["train"].filter(lambda r: r["vendor"] == "help-scout")

Open the dataset on HuggingFace Source on GitHub

Other vendors in the catalog

Back to the index for all 30 vendors.