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 plan includes programmatic API access. Generate keys under Settings → Integrations → API keys.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "X-Tenant-ID: YOUR_TENANT_UUID" \
     https://api.allocentra.co.za/api/v1/devices/

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