The UserCreate event fires whenever a new user is provisioned in the HoopAI platform. It delivers the full user profile including identity, contact details, assigned role, and granular feature permissions. Use this event to synchronize user records to external systems, trigger onboarding workflows, or audit access changes.
Payload
| Field | Type | Description |
|---|
type | string | Always "UserCreate" |
id | string | Unique identifier for the newly created user |
firstName | string | User’s first name |
lastName | string | User’s last name |
email | string | User’s email address |
phone | string | User’s phone number in E.164 format |
extension | string | Telephony extension assigned to the user |
locationId | string | Account ID the user belongs to; present for location-level users |
companyId | string | Company ID the user belongs to; present for admin-level users |
role | string | Assigned role, e.g. "user" or "admin" |
permissions | object | Map of boolean flags controlling the user’s feature access (e.g., campaigns, payments, workflows) |
locations | array | List of location IDs the user has access to |
Example payload
{
"type": "UserCreate",
"id": "ve9EPM428h8vShlRW1KT",
"firstName": "John",
"lastName": "Doe",
"email": "john.doe@example.com",
"phone": "+19509597501",
"extension": "101",
"locationId": "otg8dTQqGLh3Q6iQI55w",
"role": "user",
"permissions": {
"campaignsEnabled": true,
"appointmentsEnabled": true,
"workflowsEnabled": true,
"paymentsEnabled": false
}
}
- Accounts API — manage and retrieve account details
- Users API — list, create, and update users programmatically
Last modified on March 5, 2026