webhooks
Create webhook
Create a new webhook configuration. Maximum 10 webhooks per user. Webhooks are automatically disabled after 10 consecutive delivery failures.
AuthorizationBearer <token>
API key authentication - use your Late API key as a Bearer token
In: header
name?string
Webhook name (max 50 characters)
Length
length <= 50url?string
Webhook endpoint URL (must be HTTPS in production)
Format
urisecret?string
Secret key for HMAC-SHA256 signature verification
events?array<string>
Events to subscribe to
isActive?boolean
Enable or disable webhook delivery
customHeaders?
Custom headers to include in webhook requests
Response Body
application/json
application/json
curl -X POST "https://getlate.dev/api/v1/webhooks/settings" \ -H "Content-Type: application/json" \ -d '{ "name": "My Production Webhook", "url": "https://example.com/webhook", "secret": "your-secret-key", "events": [ "post.scheduled", "post.published", "post.failed", "post.partial", "account.connected", "account.disconnected", "message.received" ], "isActive": true }'{
"success": true,
"webhook": {
"_id": "string",
"name": "string",
"url": "http://example.com",
"secret": "string",
"events": [
"post.scheduled"
],
"isActive": true,
"lastFiredAt": "2019-08-24T14:15:22Z",
"failureCount": 0,
"customHeaders": {
"property1": "string",
"property2": "string"
}
}
}Empty
{
"error": "Unauthorized"
}