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": "019dc79a-824a-712f-a68e-5e42e7ce7834",
      "organization": "019dc79a-824a-712f-a68e-5e43370231cc",
      "target_hook_url": "https://webhook.site/unique-url",
      "timestamp_created": "2026-04-26T02:24:45.130Z",
      "campaign": "019dc79a-824a-712f-a68e-5e443ab917c5",
      "name": "Zapier Positive Replies",
      "event_type": "email_sent",
      "custom_interest_value": 1,
      "headers": {
        "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
      },
      "status": 1,
      "timestamp_error": "2026-04-26T02:24:45.130Z"
    }
  ],
  "next_starting_after": "019dc79a-c590-76ea-b366-0055967b8d5f"
}

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:

"019dc79a-c590-76ea-b366-00540a166704"

​
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:

"019dc79a-c590-76ea-b366-0055967b8d5f"