Conversation events webhook

This webhook is triggered when subscribed conversation events occur. You can create webhook subscriptions via the /v1/webhooks endpoint to receive these events.

Available Event Types:

• CONNECTION_REQUEST_SENT: Triggered when a LinkedIn connection request is sent
• CONNECTION_REQUEST_ACCEPTED: Triggered when a contact accepts a connection request
• LINKEDIN_MESSAGE_SENT: Triggered when a LinkedIn message is sent
• EMAIL_SENT: Triggered when an email is sent
• INMAIL_SENT: Triggered when a LinkedIn InMail is sent
• MESSAGE_REPLIED: Triggered when a contact replies to any message

Webhook Authentication: If you provide a secret when creating your webhook subscription, it will be included in the request headers as X-Webhook-Secret. You can use this to verify that the webhook is coming from Genesy.

Campaign Filtering: When creating a webhook, you can specify campaignIds to only receive events from specific campaigns. If not specified or empty, you’ll receive events from all campaigns.

Custom Fields: You can specify additional contact/company fields to include in the webhook payload via the customFields parameter when creating the webhook.

Retry Logic:

• Genesy will retry failed webhook deliveries up to 3 times
• Retry intervals: 30 seconds, 5 minutes, 50 minutes (exponential backoff)
• Your endpoint should respond with a 2xx status code to acknowledge receipt

Example webhook creation:

{
  "url": "https://your-domain.com/webhooks/genesy",
  "secret": "your-secret-key",
  "events": ["MESSAGE_REPLIED", "EMAIL_SENT"],
  "campaignIds": [123, 456],
  "customFields": ["mobilePhone", "leadCountry"]
}