Configuring Webhooks
Learn how to register a webhook endpoint, choose which events to receive, and verify incoming signatures for security.
Webhooks let external systems react instantly whenever something changes inside USystems Atlas, instead of polling the API on a schedule. You register a single HTTPS URL, and Atlas pushes an event payload to it as soon as a matching action occurs.
To get started, open Settings > Integrations > Webhooks and click Add Endpoint. Paste in a publicly reachable HTTPS URL and select the events you care about, such as patient.created, patient.updated, invoice.paid, or user.deactivated. You can subscribe to as many event types as you need on a single endpoint, or split them across multiple endpoints.
Every webhook request includes an X-Atlas-Signature header, a hash of the payload generated with the signing secret shown on the endpoint's detail page. Your receiving server should recompute this hash and reject any request where the signatures don't match, which protects you against spoofed requests.
If a delivery fails, Atlas retries with exponential backoff for up to 24 hours, and the delivery log shows every attempt along with the response your server returned. Use the log to debug misconfigured URLs or unexpected downtime quickly.
Was this helpful?