Send signups to a webhook

Send each Veya signup to your CRM, Zapier, Make or your own backend with a signed webhook, and verify the signature and handle retries.

A webhook sends each signup to an HTTPS endpoint you run. It works alongside Klaviyo: a signup goes to Klaviyo and to every webhook that takes its form.

There's no dashboard screen for webhooks yet. You set them up over MCP, by asking your AI tool, or through the REST API with a key from Settings > Agents & API.

Create one

POST https://app.veyapopups.com/api/webhooks
Authorization: Bearer vk_...

{"url": "https://example.com/veya", "formIds": []}

Leave formIds empty to take every form. The response includes a secret (whsec_...) shown only once, so save it.

The URL has to be https on a public host. A store can have 5 webhooks, each taking up to 100 forms.

Call What it does
GET /api/webhooks Lists webhooks with delivery counts and the latest failure
PUT /api/webhooks/{id} Changes the URL or forms, or turns it off with enabled: false
POST /api/webhooks/{id}/test Sends one signup.test event and returns your endpoint's answer
POST /api/webhooks/{id}/retry Queues failed deliveries again
DELETE /api/webhooks/{id} Deletes it and its undelivered signups

What you receive

One POST per signup, with a type of signup.created:

{
  "type": "signup.created",
  "timestamp": "2026-10-13T17:02:11Z",
  "data": {
    "id": "0199e0c4-...",
    "formId": "0199d...",
    "email": "ana@example.com",
    "phone": "",
    "emailConsent": true,
    "smsConsent": false,
    "answers": [{ "id": "skin", "label": "Skin type?", "property": "skin_type", "value": "Dry" }],
    "properties": { "veya_form": "Skin quiz", "skin_type": "Dry" },
    "createdAt": "2026-10-13T17:02:11Z"
  }
}

Check emailConsent and smsConsent before you send marketing.

Verify the signature

Webhooks follow the Standard Webhooks format, with three headers: webhook-id, webhook-timestamp and webhook-signature.

import { createHmac, timingSafeEqual } from 'node:crypto';

function verify(rawBody, headers, secret) {
  const key = Buffer.from(secret.replace(/^whsec_/, ''), 'base64');
  const signed = `${headers['webhook-id']}.${headers['webhook-timestamp']}.${rawBody}`;
  const expected = Buffer.from('v1,' + createHmac('sha256', key).update(signed).digest('base64'));
  return headers['webhook-signature'].split(' ').some(sig => {
    const got = Buffer.from(sig);
    return got.length === expected.length && timingSafeEqual(got, expected);
  });
}

Sign the raw body, before any JSON parsing changes it.

Retries

Veya retries on 408, 429, 5xx, timeouts and connection failures, up to 10 attempts. Any other status fails for good, and that includes redirects. A delivery can arrive twice, so dedupe on webhook-id.

Your next popup?
We’ll build it for you.

14-day free trial on every plan. Custom design and revisions included.