Create a New User

This endpoint creates a new user in the system.

For Global Admin Tool Organizations, if the user is to be created in a Tenant Organization, the X-Degreed-Organization-Code header must be provided.

Note: The manager assigned to the user must have an employee id to be valid.

The job-role parameter can only be used if the job role enhancements setting is not enabled for your organization. If the setting is enabled, the request returns an error and you must use the v3 Users endpoint, where job-role is an object with an id field.

Required Scope

users:write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
data
object
Headers
string

For Global Admin Tool Organizations, include this header in your request to create a user for the tenant organization. You must provide your organization code as the value. Contact your Degreed technical partner if you are unsure what your organization code is.

Response

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json