Skip to main content
GET
/
v3
/
webhooks
List webhook subscriptions
curl --request GET \
  --url https://api.reply.io/v3/webhooks \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": 1823,
      "eventType": "email_replied",
      "url": "https://example.com/hooks/reply",
      "scope": "personal",
      "enabled": true,
      "createdAt": "2026-04-17T12:00:00+00:00",
      "payloadConfig": {
        "includeEmailUrl": true,
        "includeEmailText": false,
        "includeProspectCustomFields": true
      }
    }
  ],
  "hasMore": true
}

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Query Parameters

​
top
integer

Maximum number of items to return (defaults to the API page size).

Required range: x >= 1
​
skip
integer

Number of items to skip.

Required range: x >= 0

Response

Paginated list of webhook subscriptions.

​
items
WebHook · object[]
​
hasMore
boolean

Whether more items are available beyond the current page.