Setting up with API calls

Get client many webhooks

get

Retrieve multiple webhook URLs for a client.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

activebooleanOptional

Filter active webhooks

uuids[]stringOptional

Filter by webhook UUIDs

Responses

200

OK

application/json

activebooleanOptional

webhookTokenstringOptional

webhookUrlstringOptional

uuidstringOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

get/webhook-url/get-many

GET /webhook-url/get-many HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

[
  {
    "active": true,
    "webhookToken": "wis-wht_IYXYVOI2ZP2C3CXOCP",
    "webhookUrl": "http://<your-webhook-url>",
    "uuid": "c780fddb-1b37-4155-9f55-d229f77faaaf",
    "createdAt": "2024-06-04T10:29:10.656Z",
    "updatedAt": "2024-06-04T10:29:10.656Z"
  }
]

Create new webhook

post

Create a new webhook URL.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

webhookUrlstringRequired

Responses

201

Created

application/json

activebooleanOptional

webhookTokenstringOptional

webhookUrlstringOptional

uuidstringOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

post/webhook-url/

POST /webhook-url/ HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "webhookUrl": "http://<your-webhook-url>"
}

201

Created

{
  "active": true,
  "webhookToken": "text",
  "webhookUrl": "text",
  "uuid": "text",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Update webhook URL

put

Update an existing webhook URL.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

uuid-webhookstringRequired

UUID of the webhook to update

Body

webhookUrlstringRequired

Responses

200

OK

application/json

activebooleanOptional

webhookTokenstringOptional

webhookUrlstringOptional

uuidstringOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

put/webhook-url/{uuid-webhook}

PUT /webhook-url/{uuid-webhook} HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "webhookUrl": "http://<your-webhook-url>"
}

200

OK

{
  "active": true,
  "webhookToken": "text",
  "webhookUrl": "text",
  "uuid": "text",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Delete webhook URL

delete

Delete an existing webhook URL.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

uuid-webhookstringRequired

UUID of the webhook to delete

Responses

204

No Content

No content

delete/webhook-url/{uuid-webhook}

DELETE /webhook-url/{uuid-webhook} HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content

Test webhook URL

post

Test an existing webhook URL.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

uuid-webhookstringRequired

UUID of the webhook to test

Responses

204

No Content

No content

post/webhook-url/test/{uuid-webhook}

POST /webhook-url/test/{uuid-webhook} HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content