Real-time notifications for every support event
Stay in sync with your TidySupport workspace in real-time. Set up webhooks to receive instant HTTP notifications when conversations are created or closed, new messages arrive from customers, and contacts are added.
{
"event": "conversation.created",
"version": 1,
"timestamp": "2024-01-15T10:30:00.000Z",
"payload": {
"conversation": {
"id": "cnv_abc123",
"workspaceId": "wrk_xyz789",
"contactId": "cnt_def456"
}
}
}Why use webhooks?
Real-time Updates
Get notified instantly when support events happen instead of constantly polling for changes.
Automatic Sync
Keep your external systems in sync automatically when conversations, messages, and contacts change in TidySupport.
Custom Workflows
Trigger custom business logic in your application based on support activity—escalate tickets, update CRM records, or send internal alerts.
Efficient Processing
Reduce server load and improve performance by eliminating unnecessary API polling.
Event Tracking
Build custom analytics and automation flows from real-time support events happening in your workspace.
Integration Friendly
Connect TidySupport with any system that can receive HTTP POST requests.
Available webhook events
Subscribe to the support event families that matter to your application:
Conversation Events
conversation.created — new conversation started by a customer
conversation.closed — conversation resolved by your team
Message Events
message.received — new message received from a customer
Contact Events
contact.created — new contact added to your workspace
Additional Events
CONVERSATION_UPDATED, CONVERSATION_ASSIGNED, CONVERSATION_REOPENED, MESSAGE_UPDATED
Getting started with webhooks
1. Set up your endpoint
Create an endpoint in your application that can receive HTTP POST requests from TidySupport.
2. Create a webhook
Use our API or dashboard to create a webhook and select which support events to subscribe to.
3. Handle the events
Process the webhook payloads in your application to trigger custom support workflows.
Ready to go real-time?
Set up webhooks in minutes and start receiving instant notifications when support events happen in your TidySupport workspace.