How to Create New Users

Humata provides a straightforward API solution for organizations to handle user sign-up and login processes.

Create a new user.

post

This endpoint allows organization admins to create new user accounts.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key provided as a Bearer token in the Authorization header.

Body

application/json

first_namestringRequiredExample: John

last_namestringRequiredExample: Doe

emailstringRequiredExample: [email protected]

passwordstringRequiredExample: password

bypass_email_verificationbooleanOptionalExample: true

Responses

201

User created successfully.

application/json

post

/v1/users

HTTPcURLJavaScriptPython

POST /api/v1/users HTTP/1.1
Host: app.humata.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "[email protected]",
  "password": "password",
  "bypass_email_verification": true
}

201

User created successfully.

{
  "id": "9294544b-2b6a-4c93-976c-d1910b8c1423",
  "first_name": "John",
  "last_name": "Doe",
  "email": "[email protected]"
}

Generate an OTP Token for a User

post

This endpoint allows organization admins to generate a One-Time Password (OTP) token for their users. OTP tokens expire after 60 minutes.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key provided as a Bearer token in the Authorization header.

Body

application/json

emailstringRequiredExample: [email protected]

providerstringOptionalExample: email

Responses

200

Token generated successfully.

application/json

post

/v1/users/token

HTTPcURLJavaScriptPython

POST /api/v1/users/token HTTP/1.1
Host: app.humata.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "email": "[email protected]",
  "provider": "email"
}

200

Token generated successfully.

{
  "token": "fjlgkspwzytqxnh...."
}