How do I send my task updates to another app, like Zapier?
Add a webhook in Settings, Integrations, and each task event you choose is sent to your address, signed so you can trust it.
A webhook sends a message to another app the moment something happens to a task, for example when someone finishes one. Zapier, Make, your own server or your CRM can then act on it. Only your organization's admin can set one up.
Add a webhook
- Click Settings in the sidebar, then Integrations, then Webhooks.
- Under Add a webhook, paste the address the other app gave you. It has to start with https://. Addresses on your own computer or office network, such as localhost, are refused.
- Tick the events you want sent. Task completed by a person is ticked for you.
- Click Add webhook. Your signing secret appears at the top of the page.
- Click Copy and store the secret in the other app or on your server. This is the only time it is shown. Click Done when you have it.
You can have up to ten webhooks.
What gets sent
Each event arrives as a POST with a JSON body: an id, the event type, when it happened, and the task's details, such as the task, the customer and who did it. The same id is used if we send an event again, so you can ignore one you have already handled.
Check it really came from us
Every request carries an X-Peakify-Signature header. It reads sha256= and then an HMAC-SHA256 of the raw request body, made with your signing secret, in hex. Work out the same value on your side and only trust the request when the two match.
If your app is down
Reply with any 2xx status to say you got it. Anything else, or no answer, and we try again after 1 minute, then 5 minutes, then 30 minutes, four tries in all. After that the event is dropped.
Remove a webhook, or lost the secret
Click Remove next to the address and confirm. Events stop straight away, including any tries still waiting. If you lost the secret, remove the webhook and add it again, you get a new secret.
Was this useful?
More in Settings and your account
The other guides people read alongside this one.
- Where do I go to change something about my account or business?
Click Settings in the sidebar, it opens into a list of areas, click the one you need.
- How do I update my business name, logo, contact details or address?
Go to Settings, then General, update whatever's changed and press Save changes. Your logo, brand colour and contact details are what your customers see on the emails you send them. Only admins can save.
- How do I set my timezone and business hours?
Set them on the General tab. Your AI assistant and your scheduling tools both use these to know when you're actually open.
- How do I give my customers a link to sign in and see their documents?
Claim a short web address under General. Depending on your plan, that address becomes the one page your customers use to ask for a link, either a sign-in link or a link to their own progress.
Did this not cover it?
Start a chat and the assistant will try first. If it cannot help, it hands you to a person.
Or email support@peakifyhub.com. We answer within 1 business day, Mon–Fri.