Integrations · How-to
Send Setvos events to your other systems with webhooks
Tell another system when something happens here — a contact added, a deal won, an invoice paid, a booking made — by posting it to an address you choose.
Create a webhook
In Integrations › API and webhooks, which people with the workspace-settings permission see, press “New webhook”. Enter the “URL” that should receive events and tick the “Events” it needs:
- a contact added or changed
- a deal moved to another stage, or won
- an invoice paid
- a booking made or cancelled
- an order paid
Copy the signing secret
The “Signing secret” is shown once. Every delivery is signed with it in the X-Setvos-Signature header, so your system can check that a message really came from Setvos.
Send a test
Press the “Send a test” button (the lightning bolt) on the webhook. Your system receives a short test message, which shows the address works.
Watch the deliveries
“Recent deliveries” shows each one as “Queued”, “Delivered” or “Failed”. A delivery your system does not accept stays “Queued” and is tried again — six attempts in all, over about nine hours — before it is marked “Failed”. After twenty failed attempts in a row the webhook is paused and marked “Paused”; press “Resume” (the play button) once your system is back.
Pause or remove it
“Pause” (the pause button) stops deliveries until you press “Resume”. “Delete” (the bin) asks first: type the address’s host, such as example.com, to confirm. A deleted webhook and its signing secret cannot be brought back, so pause it if you only need a break.
Connect Zapier or Make
There is no Setvos app in their directories yet. Use their step that catches a webhook, and add the address it gives you as a new webhook here. The test message carries no record, so to map the fields, make a real change of the kind you ticked — add a test contact, for example.
Common questions
- Why was my webhook address refused?
It must be a public http or https address. An address on a private network, or one of Setvos’s own, is refused.
- Can I manage webhooks on the phone?
Yes, under Developer: add a webhook, copy its signing secret — shown once — test it, see its deliveries, or delete it after typing to confirm.
Read next
More in Integrations
- Integrations: connect the services your business already uses
- Connect a service, test it and keep it working
- Take online payments by card or by bank transfer
- Send texts through your own SMS gateway
- Connect WhatsApp, Instagram and Messenger, and Viber
- Reach clients on Telegram with @Setvos_bot or your own bot
- Link your own Telegram to add leads and get notices in a chat
- Connect a shared mailbox to the Inbox
- Issue receipts through your Checkbox cash register (ПРРО)
- Connect Nova Poshta, Ukrposhta or Meest for deliveries
- Take orders from Rozetka, Prom.ua and OLX
- See your appointments in Google, Apple or Outlook Calendar
Open in Setvos
Signed in? This article is also in the Help menu of the app.
Still stuck?
Tell us what you were trying to do — we answer in chat, in six languages. Write to us
Move your bookings off paper, WhatsApp and three spreadsheets.
Bring your clients, services and past visits in from a spreadsheet or your old system’s export, with a preview before anything is written — and help in chat, in six languages, whenever you want it. Most studios are live the same day.