Overview

Webhooks deliver real-time notifications when events occur in Connecteam, eliminating the need for polling.

Available Webhooks

Webhook	Events	Description
Time Activity	clock_in, clock_out, auto_clock_out, admin_add, admin_edit, admin_delete, and more	Time clock activities and approvals
Form Submission	form_submission, form_submission_edited, manager_field_updated	Form entries and updates
Users	user_created, user_updated, user_deleted, user_archived, user_restored, user_promoted, user_demoted	User lifecycle events
Scheduler	shift_created, shift_updated, shift_deleted, availability_status_created, availability_status_deleted	Shift and availability changes
Tasks	task_published, task_completed	Quick task events

Setup Methods

Via UI

Go to Settings → API & Integrations
Click Add webhook
Configure:
- Name: Descriptive name for your webhook
- URL: Your HTTPS endpoint
- Feature: Select the feature type
- Object: Select the specific instance (e.g., which time clock)
- Events: Choose which events to receive
Click Create webhook

🚧
Important
Only account Owners can create webhooks. The endpoint URL must be HTTPS.

Via API

See Setting up webhook via API for programmatic webhook management.

Webhook Behavior

Retry logic: Failed deliveries are retried up to 3 times, with 60 seconds between attempts
Payload format: JSON with eventType, eventTimestamp, company, and data fields
Timeout: Your endpoint should respond within 30 seconds

Common Payload Structure

All webhook payloads share these base fields:

{
  "requestId": "unique-request-id",
  "company": "company_identifier",
  "eventType": "event_name",
  "eventTimestamp": 1736760013,
  "evnetTimestamp": 1736760013,
  "activityType": "feature_type",
  "data": { }
}

Field	Type	Description
requestId	string	Unique request identifier
company	string	Company identifier
eventType	string	The event that triggered this webhook
eventTimestamp	integer	Unix timestamp of the event
evnetTimestamp	integer	Deprecated, use eventTimestamp
activityType	string	Feature type (e.g., "User", "Task", "forms")
data	object	Event-specific payload data

API Reference