Skip to main content
GET
/
api
/
v2
/
webhooks
List webhooks
curl --request GET \
  --url https://api.instantly.ai/api/v2/webhooks \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "019d9c5f-96ec-7227-8c3b-3aca802b441b",
      "organization": "019d9c5f-96ec-7227-8c3b-3acbeb40e7da",
      "target_hook_url": "https://webhook.site/unique-url",
      "timestamp_created": "2026-04-17T16:56:43.500Z",
      "campaign": "019d9c5f-96ec-7227-8c3b-3accfc17ecd3",
      "name": "Zapier Positive Replies",
      "event_type": "email_sent",
      "custom_interest_value": 1,
      "headers": {
        "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
      },
      "status": 1,
      "timestamp_error": "2026-04-17T16:56:43.500Z"
    }
  ],
  "next_starting_after": "019d9c5f-cd97-7f7f-9aa6-90e08b860d0c"
}

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:

"019d9c5f-cd97-7f7f-9aa6-90dfbb05a27e"

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

The list of Webhook

items
Webhook · object[]
required

The list of Webhook

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:

"019d9c5f-cd97-7f7f-9aa6-90e08b860d0c"