---
updatedAt: 2026-01-28T13:07:54.000Z
---

Fetch the complete documentation index at: https://developer.connecteam.com/llms.txt. Use this file to discover all available pages before exploring further.

# Overview

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

## Available Webhooks

| Webhook                                  | Events                                                                                                       | Description                         |
| :--------------------------------------- | :----------------------------------------------------------------------------------------------------------- | :---------------------------------- |
| [Time Activity](time-activity-webhook-1) | clock\_in, clock\_out, auto\_clock\_out, admin\_add, admin\_edit, admin\_delete, and more                    | Time clock activities and approvals |
| [Form Submission](forms-webhook)         | form\_submission, form\_submission\_edited, manager\_field\_updated                                          | Form entries and updates            |
| [Users](users-webhook)                   | user\_created, user\_updated, user\_deleted, user\_archived, user\_restored, user\_promoted, user\_demoted   | User lifecycle events               |
| [Scheduler](scheduler-webhook)           | shift\_created, shift\_updated, shift\_deleted, availability\_status\_created, availability\_status\_deleted | Shift and availability changes      |
| [Tasks](tasks-webhook)                   | task\_published, task\_completed                                                                             | Quick task events                   |

## Setup Methods

### Via UI

1. Go to **Settings** → **API & Integrations**
2. Click **Add webhook**
3. 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
4. Click **Create webhook**

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

### Via API

See [Setting up webhook via API](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:

```json
{
  "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](https://developer.connecteam.com/reference/)