Configure a webhook

Point Timemark at your endpoint, choose which events and which projects fire it, and test delivery.

When you’d do this

You want your own system to react when something happens in Teamspace, for example to log a photo upload or kick off a downstream job. A webhook makes Timemark send a POST request to your endpoint each time a chosen event occurs.

What you need

Role: Team Owner
Surface: Web
Plan: Business
Affects: Fires only for events that occur after the webhook is created

Set up the webhook

Go to Teamspace → Settings → Integrations → Webhook.
Enter your endpoint URL. It must be publicly reachable and respond to a POST request.
Confirm the trigger. The webhook fires on New photo when a new photo is uploaded.
Choose the scope: All photos, or a specific folder.
Save.

Test delivery

On the webhook you just saved, use the test or ping function to send a sample payload.
Check your endpoint logs to confirm the payload arrived.
Confirm your endpoint returned a 2xx response.

Fields you can configure

Field	What it does	Notes
Endpoint URL	Where Timemark sends the POST request	Must be public and return `2xx` within the timeout
Trigger	The action that fires a delivery	New photo (`photo.uploaded`) is currently the only trigger. See Webhook event types
Scope	Limits firing to one folder, or all team photos	Folder scope only fires for photos in that folder

Common pitfalls

No retroactive firing. The webhook fires only for events after it’s created. Existing photos won’t trigger it.
Endpoint must return 2xx in time. A timeout or error is treated as a failed delivery. Timemark retries failed deliveries, then stops once retries are exhausted.
Scope mismatch. A webhook scoped to one folder won’t fire for photos in other folders. Set the scope to All photos if you need every folder.
Behind a firewall. An endpoint behind a VPN or firewall isn’t reachable. Expose a public URL.