POST
/
admin
/
users
Invite accountant user
curl --request POST \
  --url https://api.steuerboard.com/v1/admin/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "frida@example.com",
  "roleId": "cmf41ajzv003706un4i99q1b1"
}'
{
  "id": "cmf41ajzv003706un4i99q1b1",
  "createdAt": "2024-08-20T12:34:56Z",
  "email": "alex@example.com",
  "firstName": "Alex",
  "lastName": "Müller",
  "roles": [
    {
      "id": "cmf41ajzv003706un4i99q1a0",
      "name": "accountant_admin",
      "customName": "Head of Accounting"
    }
  ]
}
This endpoint only works with the Accountant API key. More information here

Authorizations

​
Authorization
string
header
required

Bearer token authentication

Body

application/json

Invite accountant user

​
email
string<email>
required

Email address that should receive the invitation.

Example:

"frida@example.com"

​
roleId
string
required

ID of the role to assign to the invited user.

Example:

"cmf41ajzv003706un4i99q1b1"

Response

Accountant user invited

​
id
string<cuid>
required

Identifier of the accountant user.

Example:

"cmf41ajzv003706un4i99q1b1"

​
createdAt
string<date-time>
required

ISO 8601 timestamp when the accountant user record was created.

Example:

"2024-08-20T12:34:56Z"

​
email
string<email>
required

Email address of the accountant user.

Example:

"alex@example.com"

​
firstName
string | null
required

First name of the accountant user, if provided.

Example:

"Alex"

​
lastName
string | null
required

Last name of the accountant user, if provided.

Example:

"Müller"

​
roles
object[]
required

Roles assigned to the accountant user.