Create a user

deprecated

This endpoint has been deprecated and may be removed in future versions of the API.

Creates a new user. Specify the user's full name and email address to generate an email message that is sent to the user with an invitation to activate their Clumio account.

application/json

Request Body

assigned_role string
The Clumio-assigned ID of the role to assign to the user. The available roles can be retrieved via the GET /roles API. When not set, the role is determined as follows

Inviter Assigned OUs Resulting Role
Super Admin Global OU is assigned Super Admin
Super Admin Global OU is not assigned OU Admin
OU Admin Any OU Admin
email string required
The email address of the user to be added to Clumio.
full_name string required
The full name of the user to be added to Clumio. For example, type the user's first name and last name. The name displays on the User Management screen and in the body of the email invitation.
organizational_unit_ids string[]
The Clumio-assigned IDs of the organizational units to be assigned to the user.

Inviter	Assigned OUs	Resulting Role
Super Admin	Global OU is assigned	Super Admin
Super Admin	Global OU is not assigned	OU Admin
OU Admin	Any	OU Admin

Responses

200
default

Success

application/api.clumio.users=v1+json

Schema
Example (from schema)

Schema

_embedded object
Embedded responses related to the resource.
description string
A description of the role.
name string
Unique name assigned to the role.
_links object
URLs to pages related to the resource.
_self object
The HATEOAS link to this resource.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
delete-user object
A resource-specific HATEOAS link.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
update-user object
A resource-specific HATEOAS link.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
assigned_organizational_unit_ids string[]
The list of organizational unit IDs assigned to the user. This attribute will be available when reading a single user and not when listing users.
assigned_role string
Assigned Role for the user.
email string
The email address of the Clumio user.
full_name string
The first and last name of the Clumio user. The name appears in the User Management screen and is used to identify the user.
id string
The Clumio-assigned ID of the Clumio user.
inviter string
The ID number of the user who sent the email invitation.
is_confirmed boolean
Determines whether the user has activated their Clumio account. If true, the user has activated the account.
is_enabled boolean
Determines whether the user is enabled (in "Activated" or "Invited" status) in Clumio. If true, the user is in "Activated" or "Invited" status in Clumio. Users in "Activated" status can log in to Clumio. Users in "Invited" status have been invited to log in to Clumio via an email invitation and the invitation is pending acceptance from the user. If false, the user has been manually suspended and cannot log in to Clumio until another Clumio user reactivates the account.
last_activity_timestamp string
The timestamp of when the user was last active in the Clumio system. Represented in RFC-3339 format.
organizational_unit_count int64
The number of organizational units accessible to the user.

{
  "_embedded": {
    "description": "string",
    "name": "string"
  },
  "_links": {
    "_self": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "delete-user": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "update-user": {
      "href": "string",
      "templated": true,
      "type": "string"
    }
  },
  "assigned_organizational_unit_ids": [
    "string"
  ],
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "id": "string",
  "inviter": "string",
  "is_confirmed": true,
  "is_enabled": true,
  "last_activity_timestamp": "string",
  "organizational_unit_count": 0
}

Error

application/json

Schema
Example (from schema)

Schema

errors object[]
A list of errors encountered during runtime.
error_code uint32
error_message string
The reason for the error.

{
  "errors": [
    {
      "error_code": 0,
      "error_message": "string"
    }
  ]
}

POST /users-v1

Authorization

Request

Click Edit to configure Base URL

https://us-west-2.api.clumio.com

Bearer Token

Body

{
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "organizational_unit_ids": [
    "string"
  ]
}

curl -L -X POST 'https://us-west-2.api.clumio.com/users-v1' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.users=v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "organizational_unit_ids": [
    "string"
  ]
}'

curl -L -X POST 'https://us-west-2.api.clumio.com/users-v1' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.users=v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "organizational_unit_ids": [
    "string"
  ]
}'

curl -L -X POST 'https://us-west-2.api.clumio.com/users-v1' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.users=v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "organizational_unit_ids": [
    "string"
  ]
}'

curl -L -X POST 'https://us-west-2.api.clumio.com/users-v1' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.users=v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "organizational_unit_ids": [
    "string"
  ]
}'

curl -L -X POST 'https://us-west-2.api.clumio.com/users-v1' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.users=v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "organizational_unit_ids": [
    "string"
  ]
}'

curl -L -X POST 'https://us-west-2.api.clumio.com/users-v1' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.users=v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "organizational_unit_ids": [
    "string"
  ]
}'

curl -L -X POST 'https://us-west-2.api.clumio.com/users-v1' \
-H 'Content-Type: application/json' \
-H 'Accept: application/api.clumio.users=v1+json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "assigned_role": "string",
  "email": "string",
  "full_name": "string",
  "organizational_unit_ids": [
    "string"
  ]
}'

Create a user​

Authorization

Request

Create a user