Create employee

When working with the Tuum system, you must establish a distinct digital identity (Employee as API user) for each application or service. Record which API user is linked to each application or service within your internal systems, and ensure their credentials are stored securely—preferably using environment variables or a secrets management tool.

Create employee

Use the Create employee endpoint to create a new user. In the request body, set the role to SYSTEM to make the user an API user.

Shell (bash)

curl -L -X POST 'https://auth-api.sandbox.tuumplatform.com/api/v1/employees' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYW1lIjoiTGlpdmEgS2FzdCIsImVtcGxveWVlSWQiOiJJRC0xMDcxIiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTEyLTE3VDEyOjQ5OjM0IiwiZXhwIjoxNzY1OTc1Nzc0LCJyb2xlcyI6WyJBRE1JTiIsIkRBU0hCT0FSRF9CQUxBTkNFX1ZJRVdFUiIsIlNZU1RFTSJdfQ.PfjpoUcBdEyFMBEhj-S42-xuztsghzOBNGusvAqZJyk' \
-H 'Content-Type: application/json' \
--data-raw '{
  "username": "your_first_application",
  "email": "[email protected]",
  "firstName": "MyFirst",
  "lastName": "Application",
  "roles": [
    "SYSTEM"
  ]
}'

You can add additional roles and credentials during creation or later by using the dedicated endpoints.