Skip to main content
GET
/
v1
/
webhooks
cURL
curl --request GET \
  --url https://client-api.salesfinity.co/v1/webhooks \
  --header 'x-api-key: <api-key>'
{}
Retrieves all webhooks configured for the current team.

​
Response

Returns a list of webhook objects with pagination metadata. 
{
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "name": "CRM Call Sync",
      "url": "https://example.com/webhooks/salesfinity",
      "events": ["CALL_LOGGED"],
      "status": "active"
    },
    {
      "_id": "507f1f77bcf86cd799439022",
      "name": "Snooze Notifications",
      "url": "https://example.com/webhooks/snooze",
      "events": ["CONTACT_SNOOZED"],
      "status": "active"
    }
  ],
  "pagination": {
    "total": 2,
    "page": 1,
    "limit": 10,
    "pages": 1
  }
}

​
Response Fields

FieldTypeDescription
_idstringWebhook ID
namestringWebhook name
urlstringDestination URL for webhook payloads
eventsstring[]Subscribed event types
statusstringWebhook status (active or inactive)

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
page
integer
default:1

Page number

Required range: x >= 1
​
limit
integer

Items per page

Required range: 1 <= x <= 100

Response

200 - application/json

Webhooks retrieved successfully

The response is of type object.