Skip to main content
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

FieldTypeDescription
typestringAlways "UserCreate"
idstringUnique identifier for the newly created user
firstNamestringUser’s first name
lastNamestringUser’s last name
emailstringUser’s email address
phonestringUser’s phone number in E.164 format
extensionstringTelephony extension assigned to the user
locationIdstringSub-account ID the user belongs to; present for location-level users
companyIdstringAgency ID the user belongs to; present for agency-level users
rolestringAssigned role, e.g. "user" or "admin"
permissionsobjectMap of boolean flags controlling the user’s feature access (e.g., campaigns, payments, workflows)
locationsarrayList 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
  }
}
Last modified on March 4, 2026