users.created

Crewsum sends users.created when a user is created.

Event type

users.created

When it is sent

• The Create User API endpoint (POST /v1/users/users).
• Adding a user in the Crewsum app.

Crewsum sends the event only after the change is saved. A request that fails or is rejected sends no event. See Delivery for timing and retries.

Payload

data.users is an array with one user.

{
  "event": "users.created",
  "data": {
    "users": [
      {
        "userId": "acme#alex.rivera",
        "email": "alex.rivera@example.com",
        "displayName": "Alex Rivera",
        "systemRole": "assoc",
        "customFields": {
          "employeeNumber": "E-2041"
        },
        "supplierId": null,
        "startDate": "2026-01-05",
        "endDate": null,
        "createdAt": "2026-09-28T14:05:12.000Z",
        "updatedAt": "2026-09-28T14:05:12.000Z",
        "preferredTimezone": "America/Los_Angeles",
        "groups": [
          {
            "id": "group-abc123def4567890",
            "name": "Field Technicians",
            "description": "On-site installation crew",
            "userCount": 4,
            "createdAt": "2026-09-28T14:05:12.000Z",
            "updatedAt": "2026-09-28T14:05:12.000Z"
          }
        ]
      }
    ]
  }
}

userId has the form <tenant>#<username>. groups lists the user groups the user belongs to and can be missing. systemRole is one of assoc, emp, admin, tenant-admin, or visitor.

Related API calls

Create User

Get User