NuVentrec

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

  1. In the app open Connect, then Webhooks.
  2. Paste the https address your tool gave you and tick the events you want.
  3. 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

EventWhen it is sentWhat is in data
contact.createdA 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_changedA deal moves to another pipeline stage.id, title, from, to, value, contact_id, closed, outcome
task.completedA task is marked done.id, title, due_at, contact_id, deal_id, assigned_user_id
test.pingYou 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
Call now