Create new user

post

https://uapi.demandbase.com/admin/v1/user

Overview

Creates a new user within your Demandbase account.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request Body

The Create User API request body defines key attributes for a user, including identification, permissions, and default interface (view) preferences.

fullName

string

required

The full name of the user.

string

required

The email address of the user

externalId

string

required

An external identifier for the user, such as user id in your user management system.

permissionSets

array of strings

required

An array of permission sets assigned to the user. These must match the permission sets configured in the DB1 platform.

More info: Create and Manage Permission Sets

permissionSets*

department

string

required

The department the user belongs to, used for organizational grouping.

More info: Create and Manage Departments

view

string

required

The default view that defines which interface and columns the user sees upon login.

More info: Create and Manage User Views

Responses

500

Description: Returned if there was an issue on the server side and the user could not be created.

Request Body

201 Description: User successfully created Return: JSON object representing the new user

400 Description: Invalid request body or missing required fields Return: JSON error object

401 Description: Authentication failed or missing credentials Return: JSON error status object

403 Description: Returned if the authenticated credentials lacks the "User Management" permission Return: JSON error object