Skip to main content
POST
/
api
/
actor
/
users
Create User
curl --request POST \
  --url https://api.example.com/api/actor/users \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "actor_user_id": "actor-user-123",
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "business_name": "Luxury Resale Co.",
  "certificate_issuance_name": "Luxury Resale Co. - John Doe"
}
'
{
  "success": true,
  "message": "User created successfully.",
  "data": {
    "legitmark_user_token": "lm_usr_a1b2c3d4e5f6"
  }
}

Authorizations

​
x-api-key
string
header
required

API key for application authentication (format: leo_xxxxxxxxx)

Body

application/json
​
actor_user_id
string
required

Actor's internal user ID (non-PII)

Example:

"actor-user-123"

​
email
string<email>
required

User email address

Example:

"[email protected]"

​
first_name
string
required

User first name

Example:

"John"

​
last_name
string
required

User last name

Example:

"Doe"

​
business_name
string
required

Business or organization name

Example:

"Luxury Resale Co."

​
certificate_issuance_name
string
required

Name to appear on authentication certificates

Example:

"Luxury Resale Co. - John Doe"

Response

User created successfully

​
success
boolean
Example:

true

​
message
string
Example:

"User created successfully."

​
data
object