Setting up with API calls

Get client many webhooks

get

Retrieve multiple webhook URLs for a client.

Authorizations
Query parameters
activebooleanOptional

Filter active webhooks

uuids[]stringOptional

Filter by webhook UUIDs

Responses
200

OK

application/json
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
Body
webhookUrlstringRequired
Responses
201

Created

application/json
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": "2025-11-10T01:19:01.250Z",
  "updatedAt": "2025-11-10T01:19:01.250Z"
}

Update webhook URL

put

Update an existing webhook URL.

Authorizations
Path parameters
uuid-webhookstringRequired

UUID of the webhook to update

Body
webhookUrlstringRequired
Responses
200

OK

application/json
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": "2025-11-10T01:19:01.250Z",
  "updatedAt": "2025-11-10T01:19:01.250Z"
}

Delete webhook URL

delete

Delete an existing webhook URL.

Authorizations
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
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
PreviousWebhookNextSamples

Last updated