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

# List webhooks

> List webhooks for a campaign.

### Parameters

<ParamField path="id" type="string" required>
  The ID of the campaign to list webhooks for.
</ParamField>

### Response

<ResponseField name="webhooks" type="object[]">
  List of webhooks for the campaign.

  <Expandable title="webhook fields">
    <ResponseField name="id" type="string">
      The ID of the webhook.
    </ResponseField>

    <ResponseField name="createdAt" type="timestamp">
      The time the webhook was created
    </ResponseField>

    <ResponseField name="name" type="string">
      The name of the webhook (optional).
    </ResponseField>

    <ResponseField name="url" type="string">
      The URL of the webhook.
    </ResponseField>

    <ResponseField name="campaignId" type="string">
      The campaign ID for the webhook.
    </ResponseField>

    <ResponseField name="signature" type="string">
      The signature sent with events. [(read more)](/api-reference/webhooks)
    </ResponseField>

    <ResponseField name="eventTypes" type="string">
      The events the webhook will receive. [(read more)](/api-reference/webhooks)

      <Expandable title="event types">
        <ResponseField name="message.incoming" type="string">
          Subscribed to incoming messages.
        </ResponseField>

        <ResponseField name="message.status" type="string">
          Subscribed to message status updates.
        </ResponseField>

        <ResponseField name="recipient.optout" type="string">
          Subscribed to recipient opt-outs.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="numbers" type="string[]">
      The phone numbers the webhook is subscribed to.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success theme={null}
  {
    "webhooks": [
      {
        "id": "d3392dbf-ae4b-43b9-9b50-dcafa5c7h4mn",
        "createdAt": "2023-12-31T03:07:35.826Z",
        "name": "Event Service",
        "url": "https://website.com/webhook",
        "campaignId": "g1tkV7Eq",
        "signature": "aVWS7HTLR9xxMkdE",
        "eventTypes": [
          "message.incoming",
          "message.status"
        ],
        "numbers": [
          "+14159436397"
        ]
      },
      {
        "id": "c29b55aa-a622-4f99-91ba-1dc5834734eb",
        "createdAt": "2023-12-15T03:07:35.826Z",
        "name": "Revocation Service",
        "url": "https://website.com/revocations",
        "campaignId": "g1tkV7Eq",
        "signature": "7ujOMdfiow43feAS",
        "eventTypes": [
          "recipient.optout"
        ],
        "numbers": [
          "+14159436397"
        ]
      }
    ]
  }
  ```

  ```json Error theme={null}
  {
    "error": "Webhook not found"
  }
  ```
</ResponseExample>