Webhooks: send hivi-x events to your other systems
Webhooks: send hivi-x events to your other systems
Short answer: in Account → Webhooks, add an HTTPS endpoint and pick events. hivi-x POSTs a signed JSON event to it each time one of them happens. Every business plan includes webhooks.
Set up an endpoint
- Open Account → Webhooks (owner or admin).
- Enter the endpoint URL, an optional description, and tick the events to send.
- Choose Add endpoint and copy the signing secret. It's shown once; you can replace it later.
- Choose Send test event. A
webhook.testevent arrives, and hivi-x shows whether your endpoint answered with a 2xx status.
Up to 10 endpoints per workspace. For Zapier, Make or n8n, see Connect hivi-x to Zapier or Make.
Events
| Event | Sent when | Main fields |
|---|---|---|
client.created | A client is added: by hand, CSV import, capture or a converted lead | client (id, full name, email, phone, status, tags) |
client.updated | A client's details are edited | client |
client.deleted | A client is deleted | client.id only |
checklist.item_submitted | A client completes an item or uploads a file, through a secure link or their portal | client, checklist, item, file (name, type, size), submittedVia |
checklist.item_reviewed | Your team approves or sends back a submission | item.reviewStatus, rejectionReason, reviewedBy |
checklist.completed | Every applicable item on a checklist is done | client, checklist, completedAt |
extraction.confirmed | Someone confirms values read with Read fields | docType, confirmed fields (never the passport number), newlyConfirmed |
esign.envelope_completed | Everyone has signed a signature request | envelope, client.id, signers |
document.expiring | A document a client sent reaches 90, 30 or 7 days before its expiry date, or has expired | client, checklist, item, file, expiresOn, daysLeft |
Sample clients and the self-rehearsal client created for trials don't send events.
What a request looks like
POST /your/endpoint HTTP/1.1 Content-Type: application/json User-Agent: hivi-x-webhooks/1.0 Hivi-Event-Id: evt_3f2b9c0d4e5f4a6b8c7d1e2f3a4b5c6d Hivi-Event-Type: checklist.item_submitted Hivi-Delivery-Id: 6b1d2c9e-... Hivi-Signature: t=1761400800,v1=5f1c...
{ "id": "evt_3f2b9c0d4e5f4a6b8c7d1e2f3a4b5c6d", "type": "checklist.item_submitted", "createdAt": "2026-10-25T14:00:00.000Z", "workspaceId": "a8c2...", "data": { "client": { "id": "d41e...", "fullName": "Jordan Smith" }, "checklist": { "id": "9b77...", "name": "Rental application" }, "item": { "id": "pay-stub", "label": "Two recent pay stubs", "type": "checkbox" }, "file": { "id": "f3a1...", "name": "paystub-oct.pdf", "mimeType": "application/pdf", "size": 184322 }, "submittedVia": "guest_link", "submittedAt": "2026-10-25T14:00:00.000Z" } }
Ids stay the same across events, so a client.updated matches the client you stored from client.created. Check the signature before trusting a request: see Verify webhook signatures.
Delivery, retries and switching off
- Answer with any 2xx status within 10 seconds. Anything else, a redirect or a timeout is a failure.
- A failed delivery is retried after 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours, 12 hours and 24 hours: 8 attempts over about two days.
- If 5 events in a row fail every attempt, the endpoint is switched off and the account owner gets an email. Turning it back on resets the count. Events that happened while it was off aren't sent later.
- Delivery history keeps each delivery for 30 days with its status, HTTP code, error and the exact JSON body. Resend sends one again, once.
- An event can arrive more than once and out of order. Use the event
idto ignore repeats. - While the account is blocked (trial over, unpaid or ended subscription), nothing is sent.
Safety rules
- HTTPS only, to public addresses. Private, local, link-local and cloud-metadata addresses are refused, and the address is checked again before every send. Redirects aren't followed.
- No files are sent, only their names and sizes. Unconfirmed Read-fields values are never sent.
- Deleting a client also deletes stored delivery bodies about that client, except the deletion event.
- The owner and admins manage webhooks; adding, changing and deleting endpoints is recorded in the activity log.
The endpoint and whatever it forwards to are yours: hivi-x sends client data there because you set it up. Pick receivers you'd trust with that client data.
Limits
- Webhooks are outbound only. To act in hivi-x from Zapier (create clients, send checklists), use the hivi-x app for Zapier. There's no app in the Make directory.
- You choose event types, not fields. Each event always carries the fields in the table above: a client event always includes name, email and phone. There's no ids-only option.
- One signing secret per endpoint; replacing it takes effect at once.
Related
Answers are general operational information only — not legal, tax, regulatory, clinical, privacy, immigration, or professional advice. Requirements vary by matter, client, and regulator.
Frequently asked questions
- Does hivi-x have webhooks?
- Yes, on every business plan. In Account → Webhooks, add an HTTPS endpoint, choose its events and copy its signing secret. hivi-x then POSTs a JSON event to it each time one of those events happens.
- Does hivi-x work with Zapier or Make?
- Yes. For Zapier there is the hivi-x app (invite-only while Zapier reviews it), with triggers and actions. With webhooks, use Webhooks by Zapier (Catch Hook) or Make's Custom webhook as the trigger, paste its URL into hivi-x and send a test event.
- Which events can I receive?
- client.created, client.updated, client.deleted, checklist.item_submitted, checklist.item_reviewed, checklist.completed, extraction.confirmed, esign.envelope_completed and document.expiring, plus webhook.test when you send a test.
- Are uploaded files sent?
- No. Events about uploads include the file's name, type and size, never the file or a download link.
- What if my endpoint is down?
- hivi-x retries a failed delivery up to 8 times over about two days. If five events in a row fail every retry, it switches the endpoint off and emails the account owner. Each delivery stays in the history for 30 days, where you can resend it.
- How do I know a request really came from hivi-x?
- Each request has a Hivi-Signature header with a timestamp and an HMAC-SHA256 of the timestamp and body, made with the endpoint's signing secret. Recompute it and compare. See Verify webhook signatures.
- Who can set up webhooks?
- The workspace owner and admins. Staff can't see or change them.
Organize client document intake with checklists
hivi-x helps Ontario professionals collect client documents with reusable checklists, secure Canadian hosting, and exportable PDF packages.
More Features guides
- Online client forms: questions, uploads and signatures in one checklisthivi-x checklists work as online client forms. Ask questions, collect documents and get e-signatures through one secure link, with conditional items and no client account.
- Conditional checklist items: show only what applies to each clienthivi-x checklist items can show only when an earlier answer matches, so a self-employed client and a salaried one get different document lists from the same template.
- Do you still need a separate form builder with hivi-x?When a hivi-x client checklist replaces a general-purpose form builder for client intake, and when you should keep both.
- Automatic document checks for guest and account uploadsGuest links and signed-in checklist uploads show document-quality warnings without blocking the upload. Photos use self-hosted AI; PDFs receive limited checks.
- Automatic reminders: hivi-x chases missing documents for youhivi-x emails clients automatically about the documents they still owe, names each missing item, and stops when the checklist is done. E-signature requests get their own reminders.
- Electronic signatures: built in, and inside your client checklistshivi-x includes e-signature for routine documents, both as standalone signature requests and as an E-signature item inside a client checklist, with email-code signer verification, a hash-locked PDF and a certificate of completion.
- Less retyping: where hivi-x fills in client data for youFour ways hivi-x saves you from typing client details again. Capture them from other websites, let clients' my-id.ca profiles fill your forms, fill any PDF from a client record or a data file, and read fields from a client's uploaded pay stub, T4, NOA, bank statement or passport.
- Fill any PDF form with a client's detailsIn the hivi-x AI chat, attach a fillable PDF and pick a client. hivi-x fills it from the client record and the client's completed forms, flags uncertain fields and saves the result to the client's files.
- Move client details from another system into hivi-x without retypinghivi-x has no direct CRM integrations, but the Chrome extension can capture a client's details while you fill a form on another website, then add or merge them into hivi-x after your review.
- Clients with a my-id.ca profile fill your forms fasterWhen a client keeps their details in a free my-id.ca profile, forms you send from hivi-x open already filled in, and the client's photo of an ID can feed that profile.
- Find any client, document or file in secondshivi-x search finds clients by name, email or phone, plus documents, files and templates, from the header on any page or from the Clients list.
- Ask hivi-x about your clients in plain languageThe hivi-x AI chat finds clients, summarizes a client's checklist progress, lists inactive clients and unfinished forms, fills PDFs, and keeps notes and calendar events, all on self-hosted AI.
- Checklist due dates and overdue trackingSet a due date when you share a client checklist. The client sees it, you see an Overdue badge when it passes, and the automatic reminders are timed around it.
- Calendar and reminders for business usersThe hivi-x calendar holds showings, meetings, deadlines and tasks, syncs both ways with Google Calendar, emails you reminders before events, and adds client birthdays automatically.
- How hivi-x tracks deadlines: what's automatic and what you setA one-page answer to "does hivi-x track application deadlines?", covering what happens automatically, what you set yourself, and what isn't available yet.
- A client portal in eight languagesClients complete hivi-x checklists in English, French, Spanish, Portuguese, Ukrainian, Chinese, Hindi or Bengali. Here is how the language is chosen, what is translated, and what stays as you wrote it.
- hivi-x in French for Canadian businesseshivi-x works in French end to end, from the client portal and document checks to the AI chat and the French business documentation.
- Collecting documents from clients who don't read English wellPractical setup for newcomer and non-English-speaking clients in hivi-x, using the portal in their language, bilingual instructions, conditional items and phone uploads.
- Review client documents item by item: approve or send backIn hivi-x every client submission is reviewed per checklist item. Approve it, or send it back with a reason the client sees on that exact item.
- Client checklist status and progress: where each file standsEach client checklist in hivi-x shows its overall status, progress, due date and every item's review state, so you can see what's missing, what's waiting for you and what's done.
- PDF checklist report: a printable summary of a client fileGenerate a PDF report of any client checklist in hivi-x, covering each item's status and answer, signature records with a verification link, your photos and your summary.
- Duplicate document detection: catch the same file sent twiceNew guest-link and signed-in checklist uploads are checked for exact duplicates among that client’s recent uploads. A warning never rejects an upload.
- Stop receiving the same document twiceHow to set up hivi-x checklists so clients send each document once, using precise items, counts in the item name, duplicate and count warnings, and reuse of files clients already saved.
- Reuse client information, with the client in controlhivi-x lets information a client already gave, to you or to their own my-id.ca profile, flow into the next request. The client decides what to share each time.
- Repeat clients: one client, many filesIn hivi-x a client can have several cases (a lease this year, a purchase next year), each with its own checklists, documents and timeline, under one client record.
- Checklist templates and the template libraryBuild a document checklist once in hivi-x and reuse it for every client, or start from the curated template library and edit a copy.
- Standardize your document process across client filesHow to use hivi-x templates, required items, conditional items, due dates, reminders and review reasons so every client file follows the same standard.
- Industry starter checklists: send a real checklist on day oneNew hivi-x business accounts start with a ready-made checklist for their industry (real estate, mortgage, immigration or legal), which you can send immediately and edit to fit.
- Client activity timeline: who did what, and whenEvery hivi-x client page has a timeline recording shared checklists, client submissions, approvals, items sent back, signatures, document changes and co-agent access.
- Audit trail and record keepinghivi-x logs access to client data server-side and keeps those records for seven years. E-signatures carry their own event trail and certificate, and clients keep a sharing history.
- Know when a client submits: notifications for businesseshivi-x emails you each time a client uploads a file or completes a checklist item, and records it on the client's timeline. What you're told, and what you aren't yet.
- What your clients are notified aboutEvery email and in-app notice a client receives from hivi-x, from being added as a client to guest links, codes, reminders and signature requests, and what they aren't told.
- Chat with your clients inside hivi-xReal-time messaging between a business and its clients who have a my-id.ca account, opened from the client's page, with attachments, typing and unread indicators.
- Team workspaces and rolesInvite colleagues into one hivi-x workspace that shares your clients, checklists, templates and signature requests. Seats cost the plan price per person; owner, admin and staff roles decide who can do what.
- Assign clients to team membersShow who handles each client, filter the client list by person, and optionally limit staff to the clients assigned to them, with their checklists, uploads and signature requests.
- Teammate or co-agent: which to useA teammate is someone at your firm who takes a paid seat and works in your workspace. A co-agent is a partner at another firm who joins one client for free and sees only what you share.
- Team activity log and CSV exportThe owner and admins of a hivi-x workspace can see who did what, including sign-ins and client uploads, filter it by date and person, and export it as CSV.
- Connect hivi-x to Zapier, Make or n8nUse hivi-x webhooks as the trigger in Zapier, Make or n8n: add a new client to your CRM, post to Slack when a checklist is complete, or copy confirmed income figures to a spreadsheet.
- hivi-x for Zapier: triggers, actions and setupConnect hivi-x to Zapier: send a checklist when a CRM deal moves, add clients from web forms, and post to Slack when a checklist is complete. Every business plan.
- hivi-x API reference (v1)The hivi-x public API used by the Zapier app: OAuth 2.0, scopes, clients, checklists, REST hooks, errors and rate limits.
- Verify webhook signaturesCheck the Hivi-Signature header on every hivi-x webhook: an HMAC-SHA256 of the timestamp and raw body, made with the endpoint's signing secret. Examples in Node.js and Python.
- Expiry and renewal alerts for client documentshivi-x tracks when the passports, permits, licences and policies your clients sent expire, emails you 90, 30 and 7 days ahead, and asks the client for a renewed copy in one click.
- Ask a client for a renewed documentWhen a client's passport, permit or policy is about to expire, send them a secure link to upload the renewed one in one click, with a due date and automatic reminders.
- Import and export clients as CSVBring an existing client list into hivi-x from a CSV file, and export your clients or the document fields you confirmed. Checked row by row; nobody is emailed.
- Read fields from a client's pay stub, T4, NOA or passportAsk hivi-x to read a client's uploaded pay stub, T4, notice of assessment, bank statement summary or passport into fields. You check and confirm every value against the document.