Register user with password

Creates a password-based user account for the authentication flow. Use this when the client application owns the signup screen and needs Returning.AI to create a login identity before email verification.

What it is for: Register user with password. Use this as part of password-based account authentication rather than broker system ingestion.
How to use it: Send a POST request to /auth/register with the request body, query parameters, or multipart fields shown below. Authentication endpoint. It does not use the broker integration API key in the same way as /v1/... endpoints.
Successful response: HTTP 200. The body follows the endpoint schema; many integration endpoints wrap the useful payload under data with status and message.
Common error states:

400 invalid request body, query, ObjectId, pagination, file format, or missing required field.

401 missing, invalid, expired, or insufficient API key/token.

403 key is valid but cannot access this community/channel/user/resource, where supported by the service.

404 target resource, route, or community-scoped record was not found.

409 duplicate or conflicting state for create/update operations, where applicable.

500 unexpected Returning.AI service error.

curl --location 'https://api.returning.ai/auth/register' \ --header 'Content-Type: application/json' \ --data-raw '{ "email": "user@example.com", "password": "StrongPassword123!", "name": "Test User" }'

Request

Responses