How to configure webhooks from the BRANDED IAM portal to receive real-time event data in your own systems.
Webhooks allow your systems to receive real-time notifications from the BRANDED IAM portal when specific events occur — without polling our API. Instead of asking "has anything changed?", webhooks push data to you the moment something happens.
Available Webhook Events
ticket.created— A new support ticket was submitted.ticket.updated— A ticket status or priority changed.ticket.closed— A ticket was marked resolved.project.milestone_completed— A project milestone was marked complete.invoice.created— A new invoice was generated.invoice.paid— A payment was successfully processed.
How to Configure a Webhook
- Go to Account Settings → API Keys → Webhooks.
- Click Add Webhook.
- Enter your endpoint URL (the HTTPS URL on your server that will receive the webhook).
- Select the events you want to subscribe to.
- Click Save. We'll immediately send a test event to verify your endpoint is reachable.
Webhook Payload Format
All webhook payloads are sent as HTTP POST requests with a JSON body. Each payload includes an event type, a timestamp, and the relevant object data. We sign all webhook payloads with an HMAC-SHA256 signature included in the X-BIAM-Signature header — verify this signature before processing the payload to ensure the request is from BRANDED IAM and hasn't been tampered with.
Retry Logic
If your endpoint returns any status code other than 200, we retry the webhook with exponential backoff — at 5 minutes, 30 minutes, 2 hours, and 12 hours. After 4 failed attempts, the event is logged as failed and marked in the webhook dashboard for your review.