API Reference

Create user

post
https://user-api.omni.chat/v1/users

Creates a new user. Requires admin role.

Body Params
string
required

The user's display name. Only alphanumeric characters, spaces and the characters -()._ are allowed.

string
required

The user's login username (email address). Only alphanumeric characters and -.+_@ are allowed.

string
required

The user password. Must contain eight or more characters with a combination of letters (upper and lower case), numbers and symbols.

string

URL of the user's profile picture.

string | null

The seller code associated with this user.

roles
array of strings
Defaults to service

List of roles assigned to the user. Defaults to ["service"] if omitted.

roles
teams
array of objects

Teams the user is a member of.

teams
supervisedTeams
array of objects

Teams the user supervises. Required when roles includes supervisor.

supervisedTeams
configuration
object

User configuration flags. Defaults to { stickerSendingDisabled: false, cannotStartConversation: false } if omitted.

boolean

When true, marks the user as a support agent.

boolean

When true, marks the user as a bot.

boolean

When true, marks the user as an API-only user.

boolean

Whether the user should be created in a disabled state.

Responses

Updated 13 days ago

Language
Credentials
Header
URL
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 13 days ago