> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 Enginy.

**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:**
- Enginy 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:**

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



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json webhook /your-conversation-webhook-url
openapi: 3.1.0
info:
  title: Enginy API
  version: 1.0.0
  description: Public API for Enginy platform
servers:
  - url: https://openapi.enginy.ai
    description: Configured server
security: []
tags:
  - name: AI Variables
    description: >-
      Manage AI variables and discover the entity fields you can reference in
      prompts and entity requests.
  - name: Inbox
    description: >-
      Inbox endpoints for listing contact threads, reading thread messages,
      managing tags, and sending manual replies.
  - name: Workflows
    description: >-
      Build, validate, publish, run, and inspect advanced (graph) workflows,
      plus the block/condition catalog needed to author a workflow plan.
paths: {}

````