Back to Docs
API Reference7 min read

Webhooks

Learn how to receive real-time notifications when events occur in your Gravitre workflows.

Setting Up Webhooks

Configure webhook endpoints in your dashboard under Settings > Webhooks. Gravitre will send POST requests to your endpoint when events occur.

Event Types

Subscribe to specific event types: workflow.completed, workflow.failed, workflow.started, run.step_completed, and more.

// Example webhook payload
{
  "event": "workflow.completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "workflow_id": "wf_abc123",
    "run_id": "run_xyz789",
    "status": "success",
    "duration_ms": 1250
  }
}

Security

All webhook requests include a signature header (X-Gravitre-Signature) that you should verify to ensure the request is authentic.

PreviousAPI ReferenceNextAuthentication

Need more help?

Can't find what you're looking for? Our team is here to help.

Contact SupportGitHub