Allocentra Docs

Help centre

All docs

Webhooks & API keys

Receive real-time events and authenticate REST API calls.

Webhooks

Available on Growth plan and above. Configure in Settings → Integrations → Webhooks.

  • Create a webhook with a HTTPS endpoint URL and optional signing secret.
  • Select events (e.g. alert.created, ticket.updated).
  • Use Test to send a sample payload.

Payloads are JSON POST requests. Verify signatures using the secret shown when the webhook was created.

API keys

Scale and Master plans include programmatic API access, and every free trial does too. Generate keys under Settings → Integrations → API keys. The key identifies your workspace, so no tenant header is needed. Every endpoint is listed in the API reference.

curl -H "Authorization: ApiKey YOUR_API_KEY" \
     https://api.allocentra.co.za/api/v1/agents/

All API responses use the envelope format: { "data": ..., "message": "ok", "status": "success" }