Dropbox webhooks for datastores

Datastore Webhooks: Real-Time Notifications for Structured Data

Dropbox introduced webhooks earlier this year as a way for server-side applications to receive real-time notifications when a user's files change, replacing the need for constant polling. That capability now extends to datastores, giving developers the same immediate feedback for structured data updates.

What Datastore Webhooks Deliver

Datastore webhooks work much like their file-based counterparts. Whenever a user creates, updates, or deletes a datastore, Dropbox sends a notification to the URI you have registered for your app. The payload identifies which datastore(s) your server should fetch to process the change:

{
    "datastore_delta": [
        {
            "handle": "abc123",
            "dsid": "default",
            "change_type": "update",
            "owner": 12345678,
            "updater": 23456789
        },
        {
            "handle": "456xyz",
            ...
        },
        ...
    ]
}

Enabling Datastore Webhooks

If you already have a webhook URI registered for your app, it will automatically start receiving datastore notifications. To set up a new webhook, open your app in the App Console and register the URI in the appropriate section:

One important security note: datastore webhook notifications are only delivered to HTTPS endpoints. Mixed or plain HTTP destinations will not receive them.

Detailed integration guidance, including API reference material and a step-by-step tutorial, is available in the webhooks documentation.