POST
/
v1
/
organizations
/
{organizationId}
/
users
curl --request POST \
  --url https://live.copilot.fabric.inc/data-customer/v1/organizations/{organizationId}/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-site-context: <x-site-context>' \
  --data '{
  "username": "TEST_USER_5554",
  "userId": "user_123",
  "title": "Mr",
  "firstName": "John",
  "lastName": "Smith",
  "email": "+1 4534534534",
  "primaryPhone": "+1 345345345",
  "status": "ACTIVE",
  "role": "reporter",
  "groupId": "61604a30fdfacd0009816e46",
  "additionalAttributes": {}
}'
{
  "_id": "61604a30fdfacd0009816e44",
  "username": "TEST_USER_5554",
  "userId": "user_123",
  "title": "Mr",
  "firstName": "John",
  "lastName": "Smith",
  "email": "+1 4534534534",
  "primaryPhone": "+1 345345345",
  "status": "ACTIVE",
  "role": "reporter",
  "additionalAttributes": {},
  "groupId": "61604a30fdfacd0009816e46",
  "isDeleted": false,
  "createdAt": "2021-08-30T23:20:42.822Z",
  "updatedAt": "2021-08-30T23:20:42.822Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-site-context
string
required

The x-site-context header is a JSON object that contains information about the source you wish to pull from. The mandatory account is the 24 character identifier found in Copilot. The channel (Sales channel ID), stage (environment name), and date attributes can be used to further narrow the scope of your data source.

Example:

"{\"date\": \"2023-01-01T00:00:00.000Z\", \"channel\": 12, \"account\": \"1234abcd5678efgh9ijklmno\",\"stage\":\"production\"}"

Path Parameters

​
organizationId
string
required

A unique idenifier.

Example:

"TEST_USER1"

Body

application/json
A sample request to create an oraganization user.
​
username
string
required

The unique string used to identify a user.

Minimum length: 1
Example:

"TEST_USER_5554"

​
email
string
required

email of the user.

Example:

"+1 4534534534"

​
userId
string

user identifier

Example:

"user_123"

​
title
string

title of the user. If sent it has to contain 1 character or more.

Example:

"Mr"

​
firstName
string

first name of the user. If sent it has to contain 1 character or more.

Example:

"John"

​
lastName
string

last name of the user. If sent it has to contain 1 character or more.

Example:

"Smith"

​
primaryPhone
string

primary phone of the user. If sent it has to contain 2 characters or more.

Minimum length: 2
Example:

"+1 345345345"

​
status
enum<string>

status of the user. Default value will be PENDING.

Available options:
ACTIVE,
INACTIVE,
PENDING
Example:

"ACTIVE"

​
role
string

role of the user

Example:

"reporter"

​
groupId
string

Fabric internal id of the group record.

Example:

"61604a30fdfacd0009816e46"

​
additionalAttributes
object

Contains all additional attributes not captured in the schema.

Response

200
application/json
OK
​
_id
string
required

Fabric internal id of the record.

Example:

"61604a30fdfacd0009816e44"

​
username
string
required

user name of the user. It must be UNIQUE.

Example:

"TEST_USER_5554"

​
isDeleted
boolean
required

flag that indicates if the record is deleted

Example:

false

​
createdAt
string
required

date of creation of the record

Example:

"2021-08-30T23:20:42.822Z"

​
updatedAt
string
required

laste date of update of the record

Example:

"2021-08-30T23:20:42.822Z"

​
userId
string

user identifier

Example:

"user_123"

​
title
string

title of the usr

Example:

"Mr"

​
firstName
string

first name of the user

Example:

"John"

​
lastName
string

last name of the user

Example:

"Smith"

​
email
string

email of the user

Example:

"+1 4534534534"

​
primaryPhone
string

primary phone of the usr

Example:

"+1 345345345"

​
status
enum<string>

status of the user. Default value will be PENDING.

Available options:
ACTIVE,
INACTIVE,
PENDING
Example:

"ACTIVE"

​
role
string

role of the user

Example:

"reporter"

​
additionalAttributes
object

Contains all additional attributes not captured in the schema.

​
groupId
string

Fabric internal id of the group record.

Example:

"61604a30fdfacd0009816e46"