Create

POST

Creates a Rev user for a Rev organization. Rev user can be a customer or a lead of an organization.

Request

This endpoint expects an object.
accountstringOptional

The ID of the account to which the created Rev user is associated.

artifactslist of stringsOptional

The IDs of the artifacts to associate with the Rev user.

custom_fieldsmap from strings to anyOptional

Application-defined custom fields.

custom_schema_specobjectOptional

Requested custom schemas described abstractly. Every provided schema’s custom field must be specified, otherwise a bad request error is returned. If a new custom schema specifier is provided, then it will be added to the work, otherwise if a custom schema is omitted from the specifier, it remains unmodified.

descriptionstringOptional

Description of the Rev user.

display_namestringOptional

The user’s display name. The name is non-unique and mutable.

emailstringOptional

Email address of the Rev user.

external_refstringOptional

External ref is a mutable unique identifier for a user within the Dev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.

phone_numberslist of stringsOptional

Phone numbers, in E.164 format, of the Rev user.

rev_orgstringOptional

The ID of the Rev organization to which the created Rev user is associated.

tagslist of objectsOptional

Tags associated with the Rev user.

custom_schema_fragmentslist of stringsOptionalDeprecated

The schema fragment IDs associated with the Rev user.

Response

This endpoint returns an object.
rev_userobject