Integrations
Connect Zapier, Make or n8n with API keys and webhooks
Create an API key, add a webhook endpoint and connect Vailo to Zapier, Make, n8n or your own scripts
Connect Zapier, Make or n8n with API keys and webhooks
An API key lets a tool read and change tasks, projects and time entries of your workspace. A webhook tells a tool the moment something changes. Together they connect Vailo to Zapier, Make, n8n or your own code. Both are part of the Premium plan.
Who can set this up: Owner and Admin. Open Settings > API.
Create an API key
- Choose Create API key.
- Name it after the tool that will use it, for example "Zapier".
- Choose Read only (list and read) or Read and write (also create, change and delete tasks and time entries, create and change projects).
- Copy the key. It is shown once; Vailo keeps only a fingerprint. If you lose it, create a new key.
You can have up to 20 active keys. The table shows each key's first characters, its access and when it was last used. Revoke stops a key immediately.
A key acts as an integration, not as a person. It stops working if the person who created it is removed from the workspace or no longer manages API keys.
What the API can and cannot do
It reads and changes tasks, projects and time entries and lists members, up to 120 requests per minute per key. It never exposes finance data: no hourly rates, pay, amounts, budgets, clients or billing, and a request that tries to send them is rejected. The full reference is on the developer page.
Add a webhook endpoint
- Choose Add endpoint.
- Paste the URL your tool gives you (for Zapier: the "Catch Hook" URL of a Webhooks by Zapier trigger; Make: a Custom webhook; n8n: a Webhook node). It must start with https://.
- Choose the events you want: task created, updated, completed or deleted; time entry created, updated or deleted; project created or updated.
- Copy the signing secret (shown once). Tools that verify signatures use it; Zapier, Make and n8n webhook links usually do not, so keep the link private.
Use Send test event in the row menu to send a signed test message right away.
Delivery log and failures
Delivery log lists the last 100 deliveries of an endpoint: when, which event, whether it arrived, the answer and the payload. Send again repeats one delivery.
Deliveries normally arrive within about a minute. If your tool does not answer with a success code, Vailo retries after 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours. After 15 failed attempts in a row the endpoint is turned off and shows a message; fix the receiver and turn it on again. Events during the pause are not replayed. Up to 10 endpoints per workspace.
Privacy
A webhook sends task, time entry and project data (titles, people's ids, dates, durations) to the address you choose, which is outside Vailo. Only add addresses you trust, and remove an endpoint you no longer use.