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."
}

Changes

Changed in 1 of the 8 revisions of this API.7

Aug 11, 2026v1b0ed05460bbf7See the full diff
- ▲
  the response property's max was increased from 99999.00 to 999999.00 for the response status
  response-property-max-increased
- ▲
  the response property's max was increased from 99999.00 to 999999.00 for the response status
  response-property-max-increased
- ▲
  the response property's max was increased from 99999.00 to 999999.00 for the response status
  response-property-max-increased
- ▲
  the response property's max was increased from 99999.00 to 999999.00 for the response status
  response-property-max-increased
- ▲
  the response property's max was increased from 99999.00 to 999999.00 for the response status
  response-property-max-increased
- ▲
  the response property's max was increased from 99999.00 to 999999.00 for the response status
  response-property-max-increased
- ▲
  the response property's max was increased from 99999.00 to 999999.00 for the response status
  response-property-max-increased
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 8 revisions, 1 has no diff computed.

Full history