Skip to main content
POST
/
v1
/
api
/
webhooks
Create a new webhook
curl --request POST \
  --url https://backend.blooio.com/v1/api/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "webhook_url": "https://example.com/mywebhook"
}'
{
  "success": true,
  "message": "Webhook already exists"
}

Authorizations

​
Authorization
string
header
required

API key must be provided in the Authorization header as Bearer YOUR_API_KEY.

Body

application/json
​
webhook_url
string<uri>
required

The webhook endpoint URL that will receive POST requests.

Example:

"https://example.com/mywebhook"

​
webhook_type
enum<string>
default:message

Type of webhook. Defaults to 'message' if not specified.

Available options:
message,
all
Example:

"message"

​
valid_until
integer

Unix timestamp (ms) until when the webhook should be valid. Use -1 for no expiration (default).

Example:

-1

Response

Webhook already exists (idempotent).

​
success
boolean
​
message
string