Skip to main content

Integration

Complete Webhook Integration Flow​

  1. Register Webhook URL

    • Call POST /apps/api/webhooks
    • Save the secretKey securely
  2. Implement Webhook Handler

    • Create endpoint at your webhookUrl
    • Implement signature verification
    • Handle different event types
  3. Test Your Integration

    • Call POST /apps/api/webhooks/test
    • Verify your endpoint receives the test webhook
    • Check signature verification works
  4. Go Live

    • Create contracts via API
    • Monitor delivery logs for any failures
  5. Ongoing Maintenance

    • Check /apps/api/webhooks/logs periodically
    • Regenerate secret if compromised
    • Update URL if endpoint changes