endUsers

Create an end user

Create a new end user with optional profile data and sensitive metadata. Use this endpoint to establish an end user with context (language, metadata, sensitive metadata) before starting a conversation via POST /v2/conversations/. This ensures the AI Agent has full user context from the first turn. Available for custom channel (Conversations API) integrations. End users created through this endpoint that are not associated with a conversation within 24 hours of creation are automatically deleted.

post/v2/end-users/

Request

  • Base URL: https://example.ada.support/api
  • URL: https://example.ada.support/api/v2/end-users/
  • Auth: HTTP bearer

Request body

external_idstring nullable

Optional caller-supplied identifier (for example a CRM contact ID or a phone number). Maximum 36 characters; must not contain < or > characters. Values are stored case-insensitively. If an end user with this external_id already exists, that existing user is returned with HTTP 200 (idempotent upsert); otherwise a new end user is created with HTTP 201. Available for custom channel integrations only (V1).

Response

Existing end user returned. Issued when the request includes an external_id that is already mapped to an end user on the same AI Agent (idempotent upsert).

end_user_idstring

The unique Ada-generated id for the end user

external_idstring nullable

Caller-supplied identifier that links this end user to your own system (for example a CRM contact ID or a phone number). Unique per AI Agent. Null if not set. Maximum 36 characters; values are case-insensitive. Available for custom channel integrations only (V1).

created_atstring

The date and time the end user was created

updated_atstring

The date and time the end user was updated

Changes

No recorded changes to this operation across all 1 revision of this API.