Skip to main content

Create User

Create a new user with the specified username.

Requires the "Grant write resource" API permission.

Basic Parameters

ParameterDescription
EmailThe email address of this user.
Real NameThe real name (or full name) of this user.
UsernameThe name of the user to create.

Advanced Parameters

ParameterDescription
First NameThe user's given name.
Last NameThe user's surname.
NotesAn optional description or notes field. Can be viewed in the Duo Admin Panel.
StatusThe user's status. One of:

- "active" The user must complete secondary authentication. This is the default value if no status is specified.
- "bypass" The user will bypass secondary authentication after completing primary authentication.
- "disabled" The user will not be able to complete secondary authentication.

Example Output

{
"stat": "OK",
"response": {
"alias1": null,
"alias2": null,
"alias3": null,
"alias4": null,
"aliases": {},
"created": 1657222760,
"email": "jperez@example.com",
"firstname": "",
"groups": [],
"is_enrolled": false,
"last_directory_sync": null,
"last_login": null,
"lastname": "",
"notes": "",
"phones": [],
"realname": "Juan Perez",
"status": "active",
"tokens": [],
"u2ftokens": [],
"user_id": "DU0W79YFWZAJWJV6P00L",
"username": "jperez",
"webauthncredentials": []
}
}

Workflow Library Example

Create User with Duo and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop