Webhooks

Learn how to receive real-time updates from Duro using webhooks.

Webhook Events

Duro can notify your systems about these events:

• Component updates

• Document changes

• Change order status updates

• Review approvals

• Comment additions

Configuring Webhooks

mutation {
  createWebhook(input: {
    url: "https://your-domain.com/webhook"
    events: [
      COMPONENT_CREATED,
      COMPONENT_UPDATED,
      CHANGE_ORDER_STATUS_CHANGED
    ]
    secret: "your-webhook-secret"
  }) {
    webhook {
      id
      url
      events
    }
  }
}

Webhook Payload Example

{
  "event": "COMPONENT_UPDATED",
  "timestamp": "2024-03-21T15:30:00Z",
  "data": {
    "componentId": "comp_123",
    "changes": {
      "status": {
        "old": "IN_REVIEW",
        "new": "APPROVED"
      }
    }
  }
}

Security Best Practices

• Verify webhook signatures

• Use HTTPS endpoints

• Implement retry logic

• Monitor webhook health

Next Steps

Learn about Error Handling to make your integration robust.