Skip to main content

Create a Profile

POST 
/profiles

Call this endpoint on the first app launch. It initializes the user profile in Botsi, which is required for all AI Pricing operations, subscriptions, and paywall tracking.

Key Identifiers

  • profileId: A unique ID returned by Botsi. Use this to fetch paywalls and track events.

  • customerUserId (Optional): Provide your own internal ID to link profiles across devices.

    If you're adding a customerUserId to a new user profile, include only the customerUserId in the request body. This will create a new profile with a random profileId and the specified customerUserId.

    While customerUserId is an optional field, its use is strongly recommended to ensure reliable user identification across your system and Botsi.

    You must store either the profileId or customerUserId locally to authenticate all subsequent API calls.

A successful request returns a JSON object containing the details of the newly created profile. Make sure to save data.profileId and/or data.customerUserId, as they are required for the next steps in the flow.

Request​

Responses​

Profile created successfully.