Skip to Content
Webhooks & EventsOverview

Webhooks & Events

VelaFlows delivers real-time event notifications to your application via HTTP webhooks. When something happens in your workspace — a conversation is created, a lead moves stages, a message arrives — the platform sends a POST request to your configured URL.

How It Works

  1. Subscribe — Register a webhook URL and select which events you want to receive
  2. Receive — VelaFlows sends HTTP POST requests to your URL when events occur
  3. Verify — Validate the webhook signature to ensure the request is authentic
  4. Respond — Return a 200 status code within 10 seconds to acknowledge receipt
VelaFlows Event --> HTTP POST --> Your Server
                                   |
                                   |--> Verify Signature
                                   |--> Process Event
                                   |--> Return 200 OK

Event Categories

Events are organized by service:

CategoryExamplesCount
InboxConversation created, assigned, closed, message received15+
CRMLead created, stage changed, task completed, activity added10+
CustomerCustomer created, updated, merged, tagged8+
ChannelsMessage status changed, account connected/disconnected10+
WorkflowExecution started, completed, failed5+
AuthMember invited, role changed, workspace updated5+
BroadcastBroadcast sent, delivered, failed5+
SchedulingBooking created, cancelled, rescheduled5+

Browse the full list in the Event Catalog.

Integration with Zapier and Make.com

VelaFlows natively integrates with Zapier and Make.com through the Integrations API. Events are delivered as webhook payloads that these tools can process without custom code.

  • Zapier: Use the VelaFlows Zapier trigger to subscribe to events directly from a Zap
  • Make.com: Use a dedicated webhook module to receive VelaFlows events in your scenarios

Delivery Guarantees

PropertyValue
Delivery methodHTTP POST with JSON body
Timeout10 seconds per delivery attempt
Retry policyExponential backoff, up to 5 retries
Max retry window24 hours
OrderingBest-effort chronological (not strictly guaranteed)
DeduplicationUse eventId to deduplicate (each event has a unique ID)
SignatureHMAC-SHA256 via X-Webhook-Signature header

Quick Start

# 1. Create a webhook subscription
curl -X POST https://api.velaflows.com/api/v1/integrations/webhooks \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-workspace-id: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks/velaflows",
    "events": ["inbox.conversation.created", "crm.lead.stage_changed"],
    "secret": "your-signing-secret"
  }'
 
# 2. Your server receives events like:
# POST https://your-server.com/webhooks/velaflows
# Headers: X-Webhook-Signature: sha256=abc123...
# Body: { "eventId": "...", "eventType": "inbox.conversation.created", ... }

Next Steps

Common RecipesEvent Catalog