Webhooks

How webhooks work

1. Create a webhook trigger for a workflow
2. You receive a unique URL: https://zephly.ai/api/v1/webhooks/:token
3. Send a POST request to that URL with data
4. The workflow executes with your data as input

Creating a webhook

POST /api/v1/workflows/:id/webhooks
{
  "name": "From Stripe",
  "active": true
}

Response: {
  "id": "uuid",
  "token": "whk_abc123...",
  "url": "https://zephly.ai/api/v1/webhooks/whk_abc123...",
  "active": true
}

Triggering

POST https://zephly.ai/api/v1/webhooks/whk_abc123...
Content-Type: application/json

{
  "text": "New product: Wireless Headphones X1",
  "category": "electronics"
}

The JSON body is passed as input data to the first TextInput nodes in the workflow.

Use cases

• Form submission → generate a personalized response email
• New product in CMS → generate social media posts + images
• Stripe payment → generate invoice + thank you video
• Cron job → daily content generation on schedule

Security

• Webhook tokens are unique and unguessable
• Deactivate a webhook at any time without deleting it
• Rate limited: 10 triggers per minute per webhook
• Request body size limit: 1MB