Get webhook details

List webhooks

GET /v2/webhooks

Request

Use this request to retrieve a list of webhooks. You can use optional query parameters to filter your results. For example, useenabled=true to return only webhooks that are currently enabled.

curl -i -X GET \
  'https://api.equalsmoney.com/v2/webhooks' \
  -H 'Authorization: YOUR_API_KEY_HERE'

curl -i -X GET \
  'https://api.equalsmoney.com/v2/webhooks' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

Query parameters

limit

integer

The maximum number of items to return. For example, limit=25. By default, this is set to 100.Allowable values: [ 1 .. 100000 ]

offset

integer

The number of items to skip before returning the results. For example, offset=200. By default, this is set to 0.Allowable values: A valid integer

webhookEventTypeId

string (uuid)

Optional ID of the webhook event type to filter the response with.Allowable values: ≤ 36 characters

enabled

boolean

Optional query parameter to filter the response with (whether the webhook is enabled or not).Allowable values: true, false

webhookEventTypeName

boolean

Optional name of the webhook event type to filter the response with.Allowable values: ≤ 256 characters

accountId

string

The account ID to filter the response with. This is required if you have a user-level API key.Allowable values: An existing accountId (≤ 36 characters)

Response

If your request is successful, you’ll receive a 200 response.

{
  "count": 2,
  "limit": 100,
  "offset": 0,
  "rows": [
    {
      "id": "05fba7ec-f75b-4bab-adf5-4b4575fb791c",
      "productId": "d926625b-5e11-4ec1-b4cd-0af2a8021efc",
      "accountId": "F12345",
      "webhookEventTypeId": "64b18e0e-4561-4509-ad35-ecc8d342d291",
      "url": "https://webhook.site/217ab475-3c10-4b2c-80e0-c8c2c50ba9aa",
      "enabled": true,
      "authorizationHeader": null,
      "sharedSecret": null,
      "createdAt": "2023-11-01T14:09:10.000Z",
      "updatedAt": "2023-11-01T14:09:10.000Z",
      "webhookEventTypeName": "RecipientCreated"
    },
    {
      "id": "09bbd138-6ea1-4664-806a-16d3b1b9dfbf",
      "productId": "d926625b-5e11-4ec1-b4cd-0af2a8021efc",
      "accountId": "F12345",
      "webhookEventTypeId": "25d5b682-7449-4d07-b6fc-7c9bf1239561",
      "url": "https://webhook.site/d20a8624-56df-4f14-833e-9deed69568ad",
      "enabled": true,
      "authorizationHeader": null,
      "sharedSecret": null,
      "createdAt": "2023-11-30T10:02:50.000Z",
      "updatedAt": "2023-11-30T10:02:50.000Z",
      "webhookEventTypeName": "BoxCredited"
    }
  ]
}

{
  "count": integer,
  "limit": integer,
  "offset": integer,
  "rows": [
    {
      "id": "string",
      "productId": "string",
      "accountId": "string",
      "webhookEventTypeId": "string",
      "url": "string",
      "enabled": true,
      "authorizationHeader": null,
      "sharedSecret": null,
      "createdAt": "string",
      "updatedAt": "string",
      "webhookEventTypeName": "string"
    },
    {
      "id": "string",
      "productId": "string",
      "accountId": "string",
      "webhookEventTypeId": "string",
      "url": "string",
      "enabled": true,
      "authorizationHeader": null,
      "sharedSecret": null,
      "createdAt": "string",
      "updatedAt": "string",
      "webhookEventTypeName": "string"
    }
  ]
}

For more detailed information about this request and its response, see the API reference.

Retrieve a webhook

GET /v2/webhooks/{webhookId}

Request

Use this request to get details about a given webhook, based on its id.

curl -i -X GET \
  'https://api.equalsmoney.com/v2/webhooks/d7d34e0f-c6e9-4cea-8c25-baaffa81714f' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

curl -i -X GET \
  'https://api.equalsmoney.com/v2/webhooks/{webhookId}' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'

Path parameters

webhookId

string

required

The ID of the webhook that you want to retrieve.Allowable values: An existing webhookId (≤ 36 characters)

Query parameters

accountId

string

The account ID to filter the response with. This is required if you have a user-level API key.Allowable values: An existing accountId (≤ 36 characters)

Response

If your request is successful, you’ll receive a 200 response.

{
  "sharedSecret": "123e4567-e89b-12d3-a456-426614174000",
  "enabled": true,
  "accountId": "F12345",
  "webhookEventTypeId": "da91434a-4026-42ea-84b8-d0317b64af9c",
  "url": "https://api.url.com",
  "authorizationHeader": "Basic AXVubzpwQDU1dzByYM==",
  "id": "d7d34e0f-c6e9-4cea-8c25-baaffa81714f",
  "productId": "911db6db-ef58-4992-87cd-2fe2cfde05f9",
  "webhookEventTypeName": "OrderCreated",
  "createdAt": "2023-01-30T08:30:00Z",
  "updatedAt": "2023-01-30T08:30:00Z"
}

{
  "sharedSecret": "string",
  "enabled": boolean,
  "accountId": "string",
  "webhookEventTypeId": "string",
  "url": "string",
  "authorizationHeader": "string",
  "id": "string",
  "productId": "string",
  "webhookEventTypeName": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

For more detailed information about this request and its response, see the API reference.

Group placeholder

Group

Group

List webhooks

Request

Query parameters

Response

Retrieve a webhook

Request

Path parameters

Query parameters

Response

​List webhooks

​Request

​Query parameters

​Response

​Retrieve a webhook

​Request

​Path parameters

​Query parameters

​Response

List webhooks

Request

Query parameters

Response

Retrieve a webhook

Request

Path parameters

Query parameters

Response