For developers
Webhooks
Short answer: NuVentrec can send a small JSON message to an https address you choose when a contact is created, a deal changes stage, or a task is marked done. Owners and admins add the address under Connect in the app. Tools such as Zapier and Make can receive it with their "catch a webhook" step.
Set it up
- In the app open Connect, then Webhooks.
- Paste the https address your tool gave you and tick the events you want.
- Press Send a test. The result shows under "Last deliveries".
You can have up to 10 webhooks. Each one has its own signing secret, shown next to it.
Events
| Event | When it is sent | What is in data |
|---|---|---|
contact.created | A contact is added by hand or arrives from a lead form. Imports do not send it. | id, first_name, last_name, email, phone, source, kind, via |
deal.stage_changed | A deal moves to another pipeline stage. | id, title, from, to, value, contact_id, closed, outcome |
task.completed | A task is marked done. | id, title, due_at, contact_id, deal_id, assigned_user_id |
test.ping | You press "Send a test". | message |
What we send
A POST with Content-Type: application/json:
{
"id": "0b6f6c1e-...",
"event": "deal.stage_changed",
"created_at": "2026-10-09T18:30:00.000Z",
"data": { "id": "...", "title": "123 Main St", "from": "offer", "to": "contract", "value": 45000 }
}
Headers: X-NuVentrec-Event, X-NuVentrec-Delivery (the same id as in the body; use it to ignore repeats) and X-NuVentrec-Signature.
Check that it came from us
The signature header looks like t=1760034600,v1=5f2a.... Compute an HMAC-SHA256 of t + "." + raw request body with your webhook's signing secret, as lowercase hex. It must equal v1. Reject messages whose t is more than five minutes old.
Retries
Answer with any 2xx status within 8 seconds. If you don't, we try again after about 1 minute, 5 minutes, 30 minutes, 2 hours and 12 hours. After six failed tries we stop and mark the delivery as failed. Checks run every five minutes, so a retry can be a few minutes later than listed. Redirects are not followed.
Limits and privacy
- Only https addresses on the public internet are accepted.
- A webhook sends your own business's data to the address you chose. You are responsible for who receives it.
- There is no incoming API with keys yet. To send leads into NuVentrec, post to a lead form.
Want to connect NuVentrec to the tools you already use?
Try the interactive demoBook a walkthrough