---
title: "Receive a workspace event"
method: POST
path: "workspaceEvent"
---

# Receive a workspace event

`POST workspaceEvent` (webhook)

TimeLodge signs the timestamp and raw request body with the endpoint signing secret. Return any 2xx response within ten seconds.

## Headers

- `X-TimeLodge-Event` string, required
- `X-TimeLodge-Event-ID` string, required
- `X-TimeLodge-Delivery-ID` string, required
- `X-TimeLodge-Timestamp` string, required
- `X-TimeLodge-Signature` string, required

## Payload

- WebhookEvent
  - `id` string, required
  - `type` 'test.ping' | 'client.created' | 'client.updated' | 'project.created' | 'project.updated' | 'task.created' | 'task.updated' | 'time_entry.created' | 'time_entry.updated' | 'expense.created' | 'expense.updated' | 'timesheet.updated' | 'estimate.updated' | 'invoice.updated' | 'payment.created', required
  - `occurred_at` string, date-time, required
  - `data` object, required

## Acknowledgement `200`

The event was accepted.

---

[API](https://skmtc.dev/timelodge/apis/timelodge-api.md) · [All operations](https://skmtc.dev/timelodge/apis/timelodge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timelodge/apis/timelodge-api/revisions/9072baafaa20?raw)