Skip to main content
Creates a new user in your Okta organization with or without credentials.
External DocumentationTo learn more, visit the Okta documentation.

​
Basic Parameters

ParameterDescription
ActivateExecutes activation lifecycle operation when creating the user.
EmailPrimary email address of user.
First NameGiven name of the user.
Last NameFamily name of the user.
Login EmailUnique email identifier for the user.
Mobile PhoneMobile phone number of the user.

​
Advanced Parameters

ParameterDescription
DepartmentName of the user’s department.
Display NameName of the user, suitable for display to end users.
DivisionName of the user’s division.
Employee NumberOrganization or company assigned unique identifier for the user.
Manager IDID of the user’s manager.
Next LoginWith activate=true, set nextLogin to changePassword to have the password be EXPIRED, so user must change it the next time they log in.
OrganizationName of the user’s organization.
PasswordThe password for the user (or one time password if nextLogin is set to changePassword).
TitleUser’s title, such as “Vice President.”
User TypeUsed to describe the organization to user relationship such as “Employee” or “Contractor.”

​
Example Output

{
	"id": "00ub0oNGTSWTBKOLGLNR",
	"status": "STAGED",
	"created": "2013-07-02T21:36:25.344Z",
	"activated": null,
	"statusChanged": null,
	"lastLogin": null,
	"lastUpdated": "2013-07-02T21:36:25.344Z",
	"passwordChanged": null,
	"profile": {
		"firstName": "Isaac",
		"lastName": "Brock",
		"email": "isaac.brock@example.com",
		"login": "isaac.brock@example.com",
		"mobilePhone": "555-415-1337"
	},
	"credentials": {
		"provider": {
			"type": "OKTA",
			"name": "OKTA"
		}
	},
	"_links": {
		"activate": {
			"href": "https://{yourOktaDomain}/api/v1/users/00ub0oNGTSWTBKOLGLNR/lifecycle/activate"
		},
		"self": {
			"href": "https://{yourOktaDomain}/api/v1/users/00ub0oNGTSWTBKOLGLNR"
		}
	}
}

​
Workflow Library Example

Create Temporary User with Okta
Workflow LibraryPreview this Workflow on desktop