Webhooks

Subscribe to real-time event notifications via webhooks. Create subscriptions that send HTTP POST requests to your endpoints when events occur โ€” such as ingestion tasks completing, metrics becoming available, or errors being raised.

Use cases

  • Event-driven pipelines โ€” trigger downstream processing automatically when ingestion or metrics tasks complete
  • Monitoring and alerting โ€” receive immediate notification of failures without polling
  • Integration โ€” push FM API events into your existing systems (message queues, Slack, dashboards, etc.)

Endpoints

MethodPathDescription
GET/webhooksList all webhook subscriptions
POST/webhooksCreate a new webhook subscription
GET/webhooks/:idGet a specific webhook
PATCH/webhooks/:idUpdate a webhook (URL, events, active status)
DELETE/webhooks/:idDelete a webhook subscription
POST/webhooks/:id/verifySend a verification ping to the webhook URL
POST/webhooks/:id/rotate-secretRotate the signing secret

Security

Every webhook delivery is signed with an HMAC secret. Use the signing secret to verify that incoming requests to your endpoint genuinely originated from the FM API. Rotate the secret periodically using the rotate endpoint.

Required scope: webhooks:read for viewing, webhooks:write for creating, updating, and deleting