List webhooks

List all webhooks for the workspace with optional filters

GET /api/v2/webhooks

List webhooks

cURL

curl --request GET \
  --url https://api.instantly.ai/api/v2/webhooks \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "019e3bd1-8e73-7496-a59c-b4fe54605041",
      "organization": "019e3bd1-8e73-7496-a59c-b4ffe97a644f",
      "target_hook_url": "https://webhook.site/unique-url",
      "timestamp_created": "2026-05-18T16:00:49.779Z",
      "campaign": "019e3bd1-8e73-7496-a59c-b500feeb4d68",
      "name": "Zapier Positive Replies",
      "event_type": "email_sent",
      "custom_interest_value": 1,
      "headers": {
        "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
      },
      "status": 1,
      "timestamp_error": "2026-05-18T16:00:49.779Z"
    }
  ],
  "next_starting_after": "019e3bd1-b669-7298-a991-1f55d24fe96d"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit · integer

The number of items to return

Required range: 1 <= x <= 100

Example:

10

starting_after · string

The ID of the last item in the previous page - used for pagination. You can use the value of the next_starting_after field from the previous response.

Example:

"01956fbd-0eb1-72db-a565-82977a586084"

campaign · string<uuid>

Filter by campaign ID

Example:

"019e3bd1-b669-7298-a991-1f54dbfc7c5f"

event_type · enum<string>

Filter by event type (e.g., email_sent, lead_interested, all_events)

Available options: all_events, email_sent, email_opened, email_link_clicked, reply_received, email_bounced, lead_unsubscribed, campaign_completed, account_error, lead_neutral, lead_interested, lead_not_interested, lead_meeting_booked, lead_meeting_completed, lead_closed, lead_out_of_office, lead_wrong_person

Example:

"all_events"

Response

200

application/json

The list of Webhook

items · Webhook · object[] · required

The list of Webhook

Show child attributes

next_starting_after · string

The filter for getting the next items after this one, this could either be a UUID, a timestamp, on an email depending on the specific API

Example:

"019e3bd1-b669-7298-a991-1f55d24fe96d"