---
updatedAt: 2026-01-28T10:01:57.000Z
---

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

# Users webhook

The Users webhook notifies you of user lifecycle events in real-time.

## Events

| Event Type     | Description                  | Payload        |
| :------------- | :--------------------------- | :------------- |
| user\_created  | New user added to the system | Full user data |
| user\_updated  | User profile was modified    | Full user data |
| user\_archived | User was archived            | User ID only   |
| user\_restored | User was unarchived          | User ID only   |
| user\_deleted  | User was permanently deleted | User ID only   |
| user\_promoted | User promoted to admin       | User ID only   |
| user\_demoted  | Admin demoted to user        | User ID only   |

***

## Event Examples

### user\_created

```json
{
  "requestId": "ba973227-6f19-4e5f-8847-875147a05cb9",
  "company": "your_company_id",
  "activityType": "User",
  "eventTimestamp": 1731595939,
  "eventType": "user_created",
  "data": [
    {
      "userId": 9063791,
      "firstName": "John",
      "lastName": "Smith",
      "phoneNumber": "+15253214234",
      "email": "john@example.com",
      "userType": "user",
      "isArchived": false,
      "kioskCode": "JS1234",
      "createdAt": 1731595936,
      "modifiedAt": 1731595938,
      "archivedAt": null,
      "lastLogin": 0,
      "smartGroupsIds": [],
      "invitedToBeManager": null,
      "customFields": [
        {
          "customFieldId": 6208756,
          "name": "Employment Start Date",
          "type": "date",
          "value": "24/11/2024"
        },
        {
          "customFieldId": 6208760,
          "name": "Direct manager",
          "type": "directManager",
          "value": 7053349
        }
      ]
    }
  ]
}
```

### user\_updated

```json
{
  "requestId": "57a1eb7c-27c5-4a19-9a46-7df7d885df83",
  "company": "your_company_id",
  "activityType": "User",
  "eventTimestamp": 1731596007,
  "eventType": "user_updated",
  "data": [
    {
      "userId": 9063791,
      "firstName": "John",
      "lastName": "Smith",
      "phoneNumber": "+15253214234",
      "email": "john@example.com",
      "userType": "user",
      "isArchived": false,
      "kioskCode": "JS1234",
      "createdAt": 1731595936,
      "modifiedAt": 1731596007,
      "archivedAt": null,
      "lastLogin": 0,
      "smartGroupsIds": [5321397],
      "invitedToBeManager": null,
      "customFields": [
        {
          "customFieldId": 7687992,
          "name": "Employee ID",
          "type": "str",
          "value": "EMP-2024-001"
        }
      ]
    }
  ]
}
```

### user\_archived

```json
{
  "requestId": "f04c4bff-0db4-41db-b9e5-03f3de8f5092",
  "company": "your_company_id",
  "activityType": "User",
  "eventTimestamp": 1731596054,
  "eventType": "user_archived",
  "data": [
    {
      "id": 9063791
    }
  ]
}
```

### user\_restored

```json
{
  "requestId": "b8cc847f-a9da-4bc9-8f02-d69850c938c0",
  "company": "your_company_id",
  "activityType": "User",
  "eventTimestamp": 1731596058,
  "eventType": "user_restored",
  "data": [
    {
      "id": 9063791
    }
  ]
}
```

### user\_deleted

```json
{
  "requestId": "fbbe8d61-5942-425e-8a5f-04c26cbd9b0d",
  "company": "your_company_id",
  "activityType": "User",
  "eventTimestamp": 1731596229,
  "eventType": "user_deleted",
  "data": [
    {
      "id": 9063791
    }
  ]
}
```

### user\_promoted

```json
{
  "requestId": "a57d404d-5ae8-400d-b4bb-4144a90e6e7e",
  "company": "your_company_id",
  "activityType": "User",
  "eventTimestamp": 1731596140,
  "eventType": "user_promoted",
  "data": [
    {
      "id": 9063791
    }
  ]
}
```

### user\_demoted

```json
{
  "requestId": "e0a0392e-de31-4c0e-951a-8ec2bcbd9d34",
  "company": "your_company_id",
  "activityType": "User",
  "eventTimestamp": 1731589332,
  "eventType": "user_demoted",
  "data": [
    {
      "id": 9063791
    }
  ]
}
```

***

## User Payload Fields

For `user_created` and `user_updated` events:

| Field              | Type    | Description                                         |
| :----------------- | :------ | :-------------------------------------------------- |
| userId             | integer | Unique user identifier                              |
| firstName          | string  | User's first name                                   |
| lastName           | string  | User's last name                                    |
| phoneNumber        | string  | User's phone number with country code               |
| email              | string  | User's email address                                |
| userType           | string  | `user`, `manager`, or `owner`                       |
| isArchived         | boolean | Whether the user is archived                        |
| kioskCode          | string  | Code for kiosk app access                           |
| createdAt          | integer | Unix timestamp of user creation                     |
| modifiedAt         | integer | Unix timestamp of last modification                 |
| archivedAt         | integer | Unix timestamp when archived (null if active)       |
| lastLogin          | integer | Unix timestamp of last login (0 if never logged in) |
| smartGroupsIds     | array   | IDs of smart groups the user belongs to             |
| invitedToBeManager | boolean | Whether user has pending manager invite             |
| customFields       | array   | User's custom field values                          |

***

## Fetching Additional User Data

For events that only include the user ID (archived, restored, deleted, promoted, demoted), use the [Get Users API](https://developer.connecteam.com/reference/get_users_external_api_users_v1_users_get) to fetch complete user details.

***

[API Reference](https://developer.connecteam.com/reference/user_created_eventuser_created_post)