Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sertexity.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Register Webhook

Subscribe to one or more event types. POST /webhooks  ·  🔒 Auth required

​
Request

{
  "url": "https://yourapp.com/hooks/sertexity",
  "events": ["operation.completed", "operation.failed"],
  "secret": "your_signing_secret_here"
}
FieldTypeRequiredNotes
urlstring✅Public HTTPS endpoint
eventsarray✅See Event Types
secretstring✅Used to sign payloads. Min 16 characters.

​
Response 201 Created

{
  "id": "wh_01jz1b2k4n7p9q0r",
  "url": "https://yourapp.com/hooks/sertexity",
  "events": ["operation.completed", "operation.failed"],
  "active": true,
  "created_at": "2024-09-15T10:30:00Z"
}
The secret is not returned after creation — store it securely.

​
Example

curl -X POST https://api.sertexity.com/v1/webhooks \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/hooks/sertexity",
    "events": ["operation.completed"],
    "secret": "your_signing_secret_here"
  }'