Skip to main content

Using webhooks in Dentally

๐Ÿ‡ฌ๐Ÿ‡ง๐Ÿ‡ฎ๐Ÿ‡ช๐Ÿ‡ฆ๐Ÿ‡บ๐Ÿ‡ณ๐Ÿ‡ฟ๐Ÿ‡จ๐Ÿ‡ฆ UK/ROI, APAC, CA - How to manage webhooks in Dentally

Written by Amber Morris

Webhooks allow Dentally to automatically send updates to another system whenever information changes in your practice data.

This means you can keep external tools, such as CRMs, reporting platforms, data warehouses or custom integrations updated in real time without needing to repeatedly check the API for changes.


How webhooks work

When an event happens in Dentally, such as a patient being updated or an appointment being deleted, Dentally sends a secure notification to a URL you configure.

This notification includes details about the change in a structured format (JSON), allowing your external systems to react automatically. For example, you could use webhooks to:

  • Sync patient updates with a CRM

  • Trigger workflows in automation platforms

  • Update reporting dashboards automatically

  • Keep third-party systems aligned with your Dentally data


Who can manage webhooks

Only users with administrator-level access in Dentally (Permission Level 4) can manage webhooks.

Webhooks can be managed in Settings โ†’ Developer โ†’ Webhooks

webhook settings in dentally

Supported webhook events

You can choose which events a webhook should listen for.

Dentally currently supports webhook notifications for the following records:

Record type

Supported events

Appointments

Created, updated, deleted

Patients

Created, updated, deleted

Payments

Created, updated, deleted

You can also subscribe to all supported events if you want to receive every available notification.


Failed deliveries and retries

If Dentally cannot successfully deliver a webhook notification, it will automatically retry the request.

This can happen if:

  • The receiving server is unavailable

  • The endpoint times out

  • There is a connection or security issue

  • The endpoint returns an error response

Dentally retries failed deliveries automatically using increasing delays between attempts.


Automatic webhook deactivation

To prevent repeated failed requests from generating unnecessary traffic, Dentally will automatically deactivate a webhook after 50 consecutive failed delivery attempts.

If this happens, you will need to review the endpoint and reactivate the webhook once the issue has been resolved.


Troubleshooting webhooks

When troubleshooting webhook issues, you can review delivery information including:

  • Failed deliveries

  • Successful deliveries

  • Last delivery time

This information is available within Dentally and via the API.

Did this answer your question?