Webhooks & Change Notifications

Get notified when entities change. Subscribe to updates on specific trials, drugs, or custom queries.

Stay informed when the data you care about changes.

Webhook Subscriptions

Create subscriptions that trigger when:

  • A specific entity is updated
  • New entities match a saved query
  • Status changes on trials you're tracking
  • Regulatory actions affect drugs in your portfolio

Easy Setup

  1. Go to Settings → Webhooks
  2. Add your endpoint URL
  3. Choose which events to subscribe to
  4. We'll send a test payload to verify

Payload Format

{
  "event": "entity.updated",
  "entity_type": "trial",
  "entity_id": "NCT12345678",
  "changes": {
    "status": {
      "old": "recruiting",
      "new": "completed"
    },
    "completion_date": {
      "old": null,
      "new": "2025-02-15"
    }
  },
  "timestamp": "2025-02-17T14:32:00Z"
}

Retry Logic

Failed deliveries are retried with exponential backoff:

  • 1 minute, 5 minutes, 30 minutes, 2 hours, 24 hours
  • After 5 failures, the webhook is paused
  • View delivery logs and manually retry from the dashboard

Email Digests

Don't want to build a webhook endpoint? Subscribe to daily or weekly email digests instead. Same filtering, delivered to your inbox.

Webhooks are available on Pro and Full Access plans.