The Webhooks API allows you to subscribe to real-time events from the Reply platform. When events occur, Reply will send HTTP POST requests to your specified endpoint with event details.

For detailed 2 API reference documentation, please visit Webhooks API Reference.

Table of Contents

Event Categories

Email Events

Events related to email activities and interactions:

EventDescription
auto_reply_receivedTriggered when an automated reply is received from a prospect
email_account_connection_lostTriggered when the connection to an email account is lost for any reason
email_bouncedTriggered when an email sent to a prospect fails to deliver and returns a bounce message
email_openedTriggered when a person opens your email
email_repliedTriggered when a prospect replies to an email or when a prospect’s status is set to ‘Replied’
email_sentTriggered when a new email is sent, either as the first step or as a follow-up
email_unsubscribedTriggered when a prospect unsubscribes from email communications
link_clickedTriggered when a user clicks on a link within an email sent as part of a sequence
email_spam_reportedTriggered when an email is marked as spam by the recipient
email_account_reconnectedTriggered when an email account is successfully reconnected

Sequence Events

Events related to sequence lifecycle and management:

EventDescription
sequence_startedTriggered when a sequence is started
sequence_stoppedTriggered when a sequence is stopped
sequence_completedTriggered when a sequence is completed
sequence_pausedTriggered when a sequence is paused
sequence_resumedTriggered when a sequence is resumed

Meeting Events

Events related to meeting scheduling and management:

EventDescription
meeting_bookedTriggered when a meeting is booked with a contact
meeting_cancelledTriggered when a meeting is cancelled
meeting_rescheduledTriggered when a meeting is rescheduled
meeting_completedTriggered when a meeting is completed

Response Classification Events

Events related to response categorization and sentiment analysis:

EventDescription
interested_responseTriggered when a prospect indicates interest in the offer or responds positively
meeting_requestedTriggered when a prospect requests a meeting or call
not_interested_responseTriggered when a prospect indicates they are not interested in the offer or responds negatively
reply_categorizedTriggered when a reply is categorized with a new inbox category

Contact Lifecycle Events

Events related to contact creation, updates, and lifecycle management:

EventDescription
contact_createdTriggered when a new contact is added to the system
contact_deletedTriggered when a contact is removed from the system
contact_field_updatedTriggered when a specific contact field is updated
contact_finishedTriggered when a prospect finishes a sequence, with various finish reasons
contact_opted_outTriggered when a contact opts out of communications

Task Management Events

Events related to task creation, completion, and management:

EventDescription
call_task_createdTriggered when a new call task is created for a contact
call_task_completedTriggered when a call task is completed
manual_email_task_createdTriggered when a manual email task is created for a contact
manual_email_task_completedTriggered when a manual email task is sent or completed
manual_linkedin_task_createdTriggered when a manual LinkedIn task is created for a contact
manual_linkedin_task_completedTriggered when a manual LinkedIn task is completed
task_overdueTriggered when a task becomes overdue

Communication Events

Events related to various communication channels:

EventDescription
contact_calledTriggered when a cloud call is made or logged with call details
sms_sentTriggered when an SMS is sent to a contact
sms_deliveredTriggered when an SMS is successfully delivered to a contact
sms_failedTriggered when an SMS fails to deliver

LinkedIn Events

Events related to LinkedIn activities and interactions:

EventDescription
linkedin_connection_request_sentTriggered when a LinkedIn connection request is sent to a prospect
linkedin_connection_request_acceptedTriggered when a prospect accepts a LinkedIn connection request
linkedin_message_sentTriggered when a LinkedIn message is successfully sent to a prospect
linkedin_message_repliedTriggered when a prospect replies to a LinkedIn message

Subscription Levels

Webhook subscriptions can be created at different levels to control scope:

LevelDescription
sequenceFor specific sequences (single or multiple)
accountFor all activities within a user account (default)
teamFor activities within specific teams (single or multiple)
organizationFor all activities across the entire organization

Example Subscription Request

{
  "url": "https://your-domain.com/webhooks",
  "events": ["email_opened", "email_replied"],
  "level": "sequence",
  "sequence_ids": ["seq_123", "seq_456"]
}

Delivery & Retry Policy

PolicyDetails
Success CriteriaHTTP 2xx response
Retry TriggersHTTP 429, 500, 502, network timeouts
Max Attempts5 attempts with exponential backoff
Disable Conditions- No successful deliveries within 48h
- ≥ 5 consecutive failed deliveries

Example Webhook Payload

{
  "event": "email_opened",
  "timestamp": "2025-06-27T19:18:39Z",
  "sequence_id": "seq_123",
  "data": {
    "contact_id": "cont_xyz",
    "email_id": "email_abc",
    "open_count": 1
  }
}