Which events can I subscribe to?

There are 13: lead.captured, share.viewed, video.watched, video.progress (every 10% a viewer reaches), cta.clicked, cta_link.clicked, calendar.clicked, booking.completed, video.downloaded, feedback.received, message.received, upload_request.started, and upload_request.completed. You pick any combination per endpoint, so different destinations can receive different events.

How do I verify a webhook really came from vitelnk?

Set a secret on the endpoint and vitelnk signs every payload, sending the result in an X-vitelnk-Signature header formatted as sha256 followed by the HMAC hash. Compute the same HMAC-SHA256 over the raw request body with your secret and compare.

What happens if my endpoint is down?

The delivery is retried automatically up to 5 times with escalating gaps between attempts, starting at 10 seconds and extending to 10 minutes. Every attempt is recorded in the delivery log with its HTTP status code.

What does the video.watched event actually fire on?

It fires twice per viewer: when they reach the link's watch threshold (70% unless you change it on the video or the link) and when they reach 100%. The payload has watch_percent and threshold_percent.

How many endpoints can I add, and is there a rate limit?

Up to 10 endpoints per workspace, each limited to 100 deliveries per hour. Webhooks are available on paid plans.

Know the Moment Someone Engages With Your Video

Send 10 different video engagement events to any HTTPS endpoint as they happen. Every payload is HMAC signed, retried automatically on failure, and recorded in a delivery log you can inspect.

Try It For Free Book a 15-min Demo

No card to start Cancel anytime 3 free viewers

120+ professionals already sharing smarter with vitelnk.

POSThttps://api.yourapp.com/webhooksActive

Delivery log

EventStatusTime

lead.captured200 OK11:42:08

video.watched200 OK11:41:55

cta.clicked200 OK11:40:12

13: event types you can subscribe to, each with a structured JSON payload
5: delivery attempts with escalating backoff when a delivery fails
50: most recent deliveries kept in the log with status, HTTP code, and full payload

See it in the app

The real screen in vitelnk, with the setting marked.

Step-by-step guide in the Help Center →Use it for a real job:Send a follow-up email when they watch →Capture leads and send them to your CRM →Create a link automatically for every new deal →

How It Works

Webhook Endpoint
Endpoint URL
https://hooks.acme.com/vitelnk
Events
lead.capturedvideo.watchedcta.clicked+3 more
Signing secretSet
1
Add an endpoint URL in Settings, pick which of the 13 events to send, and optionally set a signing secret.
PayloadPOST
eventvideo.watched
video_titleQ4 Product Demo
watch_percent100
share_tokena3f9c2…
X-vitelnk-Signaturesha256=4f2a…
2
vitelnk POSTs a JSON payload to your endpoint as each event happens, signed with HMAC-SHA256 when a secret is set.
Delivery Log
EventCodeTry
lead.captured2001
video.watched2001
cta.clicked5023
Retried automaticallySend test ping →
3
Check the delivery log for status, HTTP code, retry count, and the exact payload sent, or fire a test ping to verify your endpoint.

Try It For Free

No card to start Cancel anytime 3 free viewers

120+ professionals already sharing smarter with vitelnk.

Key Benefits

12 event types covering leads, link opens, watch milestones, CTA clicks, calendar bookings, downloads, messages, feedback and upload links
HMAC-SHA256 signed payloads so you can verify every delivery genuinely came from vitelnk
Automatic retries with escalating backoff, up to 5 attempts per delivery
Delivery log showing the last 50 attempts with status, HTTP code, retry count, and the full payload
Send a test ping to any endpoint and see the response code straight away
Up to 10 endpoints per workspace, so you can route different events to different destinations