Consumer Signup

POSThttps://sandbox-api.truthlocks.com/v1/consumer/signup

Register a new consumer (B2C) account. Creates a personal tenant, organization, and user. The company_name field is optional — if omitted, it defaults to the user's name + 's Workspace'. After signup, an email verification link is sent. Pending inbox deliveries (credentials minted before signup) are automatically claimed.

Body Parameters

emailstringrequired

Consumer's email address

Defaults to jane@example.com

passwordstringrequired

Password (minimum 10 characters)

namestring

Full name. Defaults to email prefix if omitted.

Defaults to Jane Doe

company_namestring

Organization name. Defaults to 'Name's Workspace' or 'Personal'.

country_codestring

ISO 3166-1 alpha-2 country code for region assignment.

Defaults to US

Responses

{
  "status": "created",
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "tenant_id": "660e8400-e29b-41d4-a716-446655440001"
}

POST/v1/consumer/signup

Language

cURL Request

Examples ▾

curl --request POST \
  --url https://sandbox-api.truthlocks.com/v1/consumer/signup \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
  "email": "jane@example.com",
  "name": "Jane Doe",
  "country_code": "US"
}'

Response

Click Try It! to send a real request, or view sample responses: