Skip to main content
Connect external services like Cal.com, Typeform, Calendly, and more directly to Sequenzy without needing Zapier or other automation platforms.

​
Overview

Custom webhooks allow you to trigger events in Sequenzy by sending HTTP POST requests from any service that supports webhooks. When an event is triggered, it can start sequences, apply sync rules, and more. Each webhook gets a unique secret URL — no API keys or special headers needed. Just paste the URL into your external service. Common use cases:
  • Trigger a sequence when someone books a call via Cal.com
  • Start onboarding emails when a form is submitted on Typeform
  • Add subscribers when they schedule a meeting on Calendly

​
Getting Started

​
1. Get Your Webhook URL

  1. Open your sequence in the editor
  2. Select a trigger node with an Event trigger (e.g., “When call-booked event received”)
  3. Find the Webhook URL section in the trigger configuration
  4. Copy the unique URL
The URL format is: 
https://api.sequenzy.com/api/inbound-webhooks/{secret}
The secret in the URL acts as authentication — no API key headers needed.

​
2. Send a Test Webhook

Paste the URL into your external service and send a test request. Sequenzy will capture the raw payload. Alternatively, you can paste an example payload directly in the Sequenzy UI.

​
3. Map Fields

Once a payload is captured, Sequenzy shows you the raw JSON and lets you map fields:
  • Email (required) — e.g., payload.attendees[0].email
  • First name — e.g., payload.attendees[0].name
  • Last name — optional
  • Custom properties — e.g., payload.duration → duration
You can click on values in the payload tree to select their path, or type the path manually.

​
4. Save and Activate

Save the mapping. Future webhooks will automatically extract the fields and trigger the event.

​
How It Works

The webhook has three states:
  1. Waiting for payload — URL is generated, waiting for the first request
  2. Payload captured — Raw payload stored, ready for field mapping
  3. Active — Mapping configured, future requests trigger events automatically
When a webhook is active and receives a request:
  1. Fields are extracted from the payload using dot-notation paths (supports array indexing like payload.items[0].email)
  2. The subscriber is created if they don’t exist
  3. The event is triggered, which can start sequences

​
Service-Specific Setup

​
Cal.com

  1. In Cal.com, go to your event type > Webhooks
  2. Click New Webhook and paste your Sequenzy webhook URL in the Subscriber URL field
  3. Leave the Secret field empty (it’s for HMAC signature verification, not needed here — your URL already contains a unique secret)
  4. Select the events you want to trigger (e.g., BOOKING_CREATED)
  5. Send a test — Sequenzy captures the payload
  6. Map fields: payload.attendees[0].email → Email, payload.attendees[0].name → First Name

​
Typeform

  1. In Typeform, go to Connect > Webhooks
  2. Add your Sequenzy webhook URL
  3. Submit a test response
  4. Map fields from the captured payload (e.g., form_response.answers[0].email → Email)

​
Calendly

  1. In Calendly, go to Integrations > Webhooks
  2. Add a webhook with your Sequenzy URL
  3. Book a test meeting
  4. Map fields: payload.invitee.email → Email, payload.invitee.name → First Name

​
Generic Webhook Sources

For any service that supports webhooks:
  1. Find the webhook configuration in the service
  2. Paste the Sequenzy webhook URL as the destination
  3. Send a test request
  4. Map the fields in Sequenzy

​
Event Properties

You can map custom properties from the payload to event properties. These are stored with the event and can be used for:
  • Filtering in sync rules
  • Personalization in emails (e.g., “Thanks for booking a -minute call!”)

​
Managing Webhooks

​
Edit Mapping

Click “Edit mapping” on an active webhook to change the field mapping.

​
Reset

Click “Reset” to clear the mapping and captured payload, returning to the “waiting for payload” state.

​
Regenerate URL

If your webhook URL is compromised, click “Regenerate URL” to create a new secret. The old URL will stop working immediately.
Regenerating the URL will break existing integrations. You’ll need to update the URL in your external service.

​
Best Practices

  1. Send a real test request from your external service before going live. This captures the actual payload format.
  2. Use descriptive event names like call-booked, form-submitted, or demo-scheduled rather than generic names.
  3. Map all relevant properties that you might want to use for personalization or filtering later.
  4. Handle errors gracefully — the webhook returns 200 even for processing errors to prevent external services from retrying unnecessarily.

​
Troubleshooting

​
Event Not Triggering Sequence

  1. Verify the webhook status is “Active” (green badge)
  2. Check that the email mapping extracts a valid email from the payload
  3. Ensure the sequence is published and active
  4. Verify the subscriber meets any conditions on the sequence

​
Mapping Not Working

  1. Check that the field paths are correct (use dot notation, e.g., payload.attendees[0].email)
  2. Verify the payload structure matches what you mapped — send another test webhook to update the sample
  3. Ensure the email field extracts a valid email address (must contain @)

​
Webhook URL Not Working

  1. Verify you’re using the correct URL (it should start with https://api.sequenzy.com/api/inbound-webhooks/)
  2. If you regenerated the URL, update it in your external service
  3. Ensure the request uses POST method with a JSON body

​
FAQ

No! Custom webhooks let you connect directly to Sequenzy without any middleman service.
No. The webhook URL contains a unique secret that acts as authentication. No headers needed.
Any JSON object. Sequenzy captures whatever your external service sends and lets you map the fields to subscriber data.
Each webhook call creates a new event. If your sequence is set to enroll subscribers only once, they won’t re-enter the sequence.
Yes, webhooks are available on all plans.
Standard API rate limits apply. For high-volume scenarios, consider using our bulk API endpoints.
Yes! In the sequence editor, ask the AI chat to help you connect external services like Cal.com or Typeform. It will guide you through the webhook configuration.