Sign in

v3

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-08-014669239.7 KB
Profile

Create Profile

Create a new profile and set initial traits. The request synchronously resolves identity and either creates a new profile ID or retrieves the associated canonical profile ID based on any provided identifier traits present in the request. The request must contain at least one trait that is promoted to an identifier in its trait group settings. Any additional traits are queued for asynchronous processing.

post/v1/Stores/{storeId}/Profiles

Request body

traitsTraitGroups

Multiple trait groups.

Example request

{
  "traits": {
    "Contact": {
      "email": "Alyssa.Mock@example.com",
      "phone": "+13175551234",
      "lastName": "Mock",
      "firstName": "Alyssa",
      "street": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94107",
      "country": "US"
    }
  }
}

Response

Profile resolved and accepted for processing.

idstring required

The canonical profile ID.

messagestring required

Example response

{
  "id": "mem_profile_00000000000000000000000000",
  "message": "Profile resolved and accepted for processing."
}