Skip to main content
POST
/
v1
/
users
Create a new user
curl --request POST \
  --url https://api-sandbox.rinne.com.br/core/v1/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifiers": [
    {
      "type": "EMAIL",
      "value": "[email protected]"
    }
  ],
  "auth_methods": [
    "PASSWORD"
  ],
  "first_name": "John",
  "last_name": "Doe",
  "roles": [
    "admin",
    "user"
  ],
  "metadata": {}
}
'
{
  "id": "user123",
  "identifiers": [
    {
      "id": "id1",
      "type": "email",
      "value": "[email protected]",
      "verified": true,
      "created_at": "2024-01-01T00:00:00.000Z",
      "verified_at": "2024-01-01T01:00:00.000Z"
    }
  ],
  "primary_identifier": {
    "id": "id1",
    "type": "email",
    "value": "[email protected]",
    "verified": true,
    "created_at": "2024-01-01T00:00:00.000Z",
    "verified_at": "2024-01-01T01:00:00.000Z"
  },
  "auth_methods": [
    "password"
  ],
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z",
  "roles": [
    {
      "id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
      "name": "admin",
      "permissions": [
        "user.create",
        "user.read",
        "role.create"
      ],
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z",
      "description": "Administrator role with full access",
      "company_id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
      "organization_id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2794"
    }
  ],
  "first_name": "John",
  "last_name": "Doe",
  "suspended_at": "2024-01-01T00:00:00.000Z",
  "metadata": {}
}

Authorizations

​
Authorization
string
header
required

JWT token for user authentication

Body

application/json

Schema for creating a new user

​
identifiers
object[]
required

Array of user identifiers (email/phone)

Minimum array length: 1
​
auth_methods
enum<string>[]

Authentication methods for the user

Available options:
PASSWORD,
GOOGLE,
CLIENT_PLATFORM
Example:
["PASSWORD"]
​
first_name
string

User's first name

Example:

"John"

​
last_name
string

User's last name

Example:

"Doe"

​
roles
string[]

Array of role names

Example:
["admin", "user"]
​
metadata
object

Additional user metadata

Response

User created successfully

​
id
string
required

User ID

Example:

"user123"

​
identifiers
object[]
required

User identifiers (email/phone)

​
primary_identifier
object
required
​
auth_methods
enum<string>[]
required

Available authentication methods

Available options:
password,
google,
client_platform
Example:
["password"]
​
created_at
string<date-time>
required

User creation timestamp

Example:

"2024-01-01T00:00:00.000Z"

​
updated_at
string<date-time>
required

User last update timestamp

Example:

"2024-01-01T00:00:00.000Z"

​
roles
object[]

User roles

​
first_name
string

User first name

Example:

"John"

​
last_name
string

User last name

Example:

"Doe"

​
suspended_at
string<date-time>

User suspension timestamp

Example:

"2024-01-01T00:00:00.000Z"

​
metadata
object

Additional user metadata