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

# Get Webhook Events

> Returns all available webhook event types

Returns a list of all available webhook event types and their descriptions. Use this endpoint to discover which events you can subscribe to when creating or updating a webhook.

### Response

Returns an array of event objects.

```json theme={null}
[
  {
    "event": "CALL_LOGGED",
    "description": "Triggered when a user logs a call, capturing relevant call details."
  },
  {
    "event": "CONTACT_SNOOZED",
    "description": "Triggered when a contact is snoozed, capturing the contact and snooze details."
  }
]
```

### Webhook delivery format

When an event fires, Salesfinity sends an HTTP `POST` to your configured webhook URL with a JSON body of the shape `{ "event": <EVENT>, "payload": <data> }`.

#### `CALL_LOGGED` payload

```json theme={null}
{
  "event": "CALL_LOGGED",
  "payload": {
    "_id": "6a3130af1ff24e60da9d1c34",
    "call_id": "call_abc123",
    "outcome": "answered",
    "direction": "outbound",
    "duration": 180,
    "to": "+1234567890",
    "from": "+1987654321",
    "disposition": { "internal_id": 1, "external_name": "Meeting Set" },
    "contact": { "first_name": "John", "last_name": "Doe", "company": "Acme Corp" },
    "contact_list": "6a312e171ff24e60da9c4a52",
    "contact_list_item": "6a312e171ff24e60da9c4973",
    "source": {
      "type": "csv",
      "id": "6a312e181ff24e60da9c5048",
      "name": "Coordinated Solutions (Month Campaign).csv"
    },
    "user": { "_id": "69e792fd2b95b13306e936ab", "first_name": "Jane", "last_name": "Smith", "email": "jane@company.com" }
  }
}
```

<Note>
  `contact_list` is the **dialing-queue** list id (`ContactList._id`) — an internal id that changes each time a list is imported for dialing. `source` identifies the **original source list**: for CSV lists, `source.id` is the CSV list id you see in [Get All Lists](/api-reference/endpoint/get-contact-lists-csv) (`/v1/contact-lists/csv`), and `source.name` is its name. For non-CSV lists, `source.id`/`source.name` are `null` and only `source.type` (e.g. `hubspot`) is provided. Use `source.id` — not `contact_list` — to match a call back to the list you dialed.
</Note>

You can filter `CALL_LOGGED` deliveries by disposition when creating the webhook (see [Create Webhook](/api-reference/endpoint/create-webhook)).


## OpenAPI

````yaml GET /v1/webhooks/events
openapi: 3.0.1
info:
  title: Salesfinity API
  description: API documentation for Salesfinity platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://client-api.salesfinity.co
security:
  - ApiKeyAuth: []
paths:
  /v1/webhooks/events:
    get:
      tags:
        - Webhooks
      description: Returns all available webhook event types
      operationId: get-webhook-events
      responses:
        '200':
          description: Webhook events retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    event:
                      type: string
                    description:
                      type: string
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````