Troubleshooting

Troubleshooting Webhooks

If your events aren't appearing on the dashboard, check the error the API returns. Every call to https://api.timehive.io/ingest answers with {"success": false, "error": "..."} when something is wrong.

1. Missing or Invalid Token (401)

Ensure you are passing the token exactly as it was provided, with no whitespace. The header must be Authorization: Bearer YOUR_TOKEN. Make sure you are posting to https://api.timehive.io/ingest. The old /api/ingest path on timehive.io is not the API.

2. Integration Is Not Active (403)

The integration is archived or paused. Set it back to active on the integration page, or create a new one.

3. Integration Is Not Linked to a Task (400)

The integration has no Default Task and the request did not include a task_id. Either send task_id in the JSON body or assign a Default Task to the integration.

4. Linked Task Not Found (404)

The task_id doesn't match a task. It must be the full Task ID (a UUID like 271a869c-316f-4568-9f1c-96fa01b297d8), not the short tsk_271a86 label. Use Copy task ID on the task or integration page.

5. Task Does Not Belong to the Integration's Project (403)

An integration can only log to tasks in its own project. Move the task, or create an integration in the task's project.

6. Daily Limit Reached (429)

You have exceeded the daily event limit for your plan. Upgrade your plan to increase this limit.

7. Dashboard Not Updating

Only events with status processed (the default) count towards time saved. failed events are logged but save nothing. If runs increase while "Time Saved" stays at 0, check the task: if Automated Time is equal to or greater than Manual Time, the net saving is zero.