Profile

Create Profile

Changed on Aug 11, 2026

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

Base URL
https://memory.twilio.com
URL
https://memory.twilio.com/v1/Stores/{storeId}/Profiles
Auth
HTTP basic

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

Aug 11, 2026v1b0ed05460bbf Revision changes
- breaking
  the response property's max was increased from 99999.00 to 999999.00 for the response status
- breaking
  the response property's max was increased from 99999.00 to 999999.00 for the response status
- breaking
  the response property's max was increased from 99999.00 to 999999.00 for the response status
- breaking
  the response property's max was increased from 99999.00 to 999999.00 for the response status
- breaking
  the response property's max was increased from 99999.00 to 999999.00 for the response status
- breaking
  the response property's max was increased from 99999.00 to 999999.00 for the response status
- breaking
  the response property's max was increased from 99999.00 to 999999.00 for the response status

Operation history