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.