Skip to main content

Create User

Adds a user. New users will only have minimal permissions, which is contacts-base. A welcome email will prompt them to set a password and log in to HubSpot.

Requirements:

STANDARD SCOPE(S): settings.users.write

GRANULAR SCOPE(S): None

LIMITS: Standard API rate limits

Basic Parameters

ParameterDescription
EmailThe created user's email.
Primary Team IDThe user's primary team.
Role IDThe user's role.
Can be obtained via the List Roles action.
Send Welcome EmailWhether to send a welcome email.

Advanced Parameters

ParameterDescription
Secondary Team IDsA comma-separated list of the user's additional teams.

Example Output

{
"id": "123",
"email": "newUser@email.com",
"roleId": "100",
"primaryTeamId": "101",
"secondaryTeamIds": [
"102"
]
}

Workflow Library Example

Create User with Hubspot and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop