vavolta
Sign In

Command Palette

Search for a command to run...

Webhooks

Receive real-time notifications when events occur in Vavolta.

Overview

Webhooks send real-time HTTP POST requests to your server when events occur in Vavolta. Use them to trigger automations, sync data, or build custom integrations.

Webhooks are available on the Team plan.

What Are Webhooks?

When something happens in Vavolta (like a form submission), we send a POST request to your URL with event details. Your server receives this and can take action.

1. User submits form on Generic Link
2. Vavolta sends POST to your webhook URL
3. Your server receives event data
4. You trigger your automation

Available Events

EventTrigger
lead_magnet.createdNew lead magnet created
lead_magnet.updatedLead magnet modified
lead_magnet.deletedLead magnet deleted
access_link.createdNew access link generated
access_link.viewedAccess link opened
generic_link.createdNew generic link created
generic_link.submittedForm submission on generic link
viewer.session_startedSomeone started viewing
viewer.session_endedViewing session completed
viewer.page_viewedSpecific page viewed (PDF)
viewer.downloadedDownload button clicked

Setting Up Webhooks

Step 1: Create Webhook Endpoint

On your server, create an endpoint that:

  • Accepts POST requests
  • Returns 200 status quickly
  • Handles JSON body

Example (Node.js/Express):

javascript

Step 2: Add Webhook in Vavolta

  1. Go to Settings > Integrations > Webhooks
  2. Click Add Webhook
  3. Enter your endpoint URL
  4. Select events to receive
  5. Click Create

Step 3: Test Your Webhook

  1. Click Test next to your webhook
  2. We send a test event
  3. Verify your endpoint received it
  4. Check response was 200

Event Payload

Standard Structure

All events have this structure:

json

Example: Form Submission

json

Example: Link Viewed

json

Example: Session Ended

json

Webhook Security

Signature Verification

Each webhook includes a signature header:

X-Vavolta-Signature: sha256=abc123...

Verify it to ensure the webhook came from Vavolta:

javascript

Webhook Secret

Get your webhook secret:

  1. Go to Settings > Webhooks
  2. View webhook details
  3. Copy the secret
  4. Store securely (environment variable)

Retry Policy

If your endpoint fails:

AttemptDelay
1st retry1 minute
2nd retry5 minutes
3rd retry30 minutes
4th retry2 hours
5th retry24 hours

After 5 failures:

  • Webhook disabled
  • Email notification sent
  • Manual re-enable required

What Counts as Failure

  • Non-2xx response
  • Timeout (30 seconds)
  • Connection refused
  • SSL errors

Managing Webhooks

Viewing Webhooks

  1. Go to Settings > Webhooks
  2. See all configured webhooks
  3. Status indicator for each

Editing Webhooks

  1. Click on a webhook
  2. Modify URL or events
  3. Save changes

Disabling Webhooks

Temporarily disable:

  1. Click on webhook
  2. Toggle Active off
  3. Events queue (not lost)
  4. Toggle on to receive queued events

Deleting Webhooks

  1. Click on webhook
  2. Click Delete
  3. Confirm
  4. No recovery possible

Webhook Logs

Viewing History

See recent webhook deliveries:

  1. Go to Settings > Webhooks
  2. Click on a webhook
  3. View Delivery History

Shows:

  • Timestamp
  • Event type
  • Response status
  • Response time

Debugging Failures

For failed deliveries:

  • See response code
  • View response body
  • See request payload
  • Retry manually

Common Use Cases

Send to Slack

Notify team of new leads:

javascript

Add to CRM

Create contact in your CRM:

javascript

Trigger Email Sequence

Start nurture sequence:

javascript

Best Practices

Respond Quickly

Return 200 immediately, process async:

javascript

Handle Duplicates

Events may be delivered more than once:

javascript

Use HTTPS

Always use HTTPS endpoints:

  • Required by Vavolta
  • Encrypts data in transit
  • Validates server identity

Log Everything

Keep logs for debugging:

  • Incoming payloads
  • Processing results
  • Errors encountered

Troubleshooting

Not Receiving Webhooks

  • Check URL is correct
  • Verify endpoint is reachable
  • Check firewall/security rules
  • Verify events are selected
  • Check webhook is active

Getting 4xx Errors

  • Check endpoint code for bugs
  • Verify signature validation
  • Check authentication if any

Getting 5xx Errors

  • Check server logs
  • Verify database connections
  • Check external service dependencies

Timeouts

  • Respond within 30 seconds
  • Process async after response
  • Optimize long operations

Next Steps