Send selected workspace events to an HTTPS endpoint with signed delivery, retries, and a seven-day replay path. Test the endpoint before relying on live events.
Before you begin
- Prepare an HTTPS endpoint that can return a successful response within 10 seconds.
- Choose only the event types the receiving service needs.
- Prepare a private secret store and signature-verification code.
Roles and permissions
An Owner or Admin can add, test, rotate, disable, or replay a webhook endpoint. Other roles cannot open API & webhooks.
Data shared and external side effects
Each delivery sends its event ID, type, occurrence time, selected payload, delivery ID, timestamp, and signature to the endpoint URL. Payload content depends on the selected event type.
Adding an endpoint does not send a request. Send test creates a signed test.ping delivery to the external URL. Live selected events and Replay also make external requests. The walkthrough used the reserved non-deliverable example.invalid domain and no third-party system.
Add and test an endpoint
- Open the account menu.
- Select API & webhooks.
- Under Add a webhook endpoint, enter Name and Endpoint URL.
- Select the required Events.
- Select Add endpoint.
- Copy Copy this secret now directly into your secret store.
- Refresh the page so the secret is no longer visible.
- Select Send test.
- Review Event, Event ID, Status, Attempts, and HTTP under Webhook endpoints and delivery history.

Expected result
A healthy test reaches delivered with a successful HTTP code. delivering means TimeLodge is attempting or retrying the request. An exhausted delivery becomes failed and shows Replay for seven days.
The verified safe endpoint remained delivering because example.invalid cannot receive it. No successful external delivery is claimed.
Disconnect and recovery
Select Disable to stop future deliveries to an endpoint. Existing history remains, and there is no re-enable control; add a new endpoint when service resumes.
Select Rotate secret to create a replacement. The previous secret remains valid for 24 hours so the receiver can move safely. A rotated secret also appears once. For a failed delivery, correct the receiver first, then select Replay within seven days. Replay keeps the original event ID and creates a new delivery record.
Troubleshooting
- A test stays delivering: Check DNS, TLS, firewall rules, and response time. TimeLodge retries transient failures with backoff.
- A delivery is failed: Correct the endpoint, then select Replay within seven days.
- The signing secret is gone: Rotate it. Never copy a secret from logs, screenshots, or a support message.
- Duplicate business work appears: Deduplicate on the stable Event ID, not the delivery attempt ID.
Related guides
Send one test now, then enable live handling only after the receiver verifies its signature and event ID.