---
title: "Create Profile"
method: POST
path: "/v1/Stores/{storeId}/Profiles"
tags: ["Profile"]
---

# Create Profile

`POST /v1/Stores/{storeId}/Profiles`

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.

## Request body

- ProfileData — Data for creating or updating a profile, including traits.
  - `traits` TraitGroups — Multiple trait groups.

## Response `202`

Profile resolved and accepted for processing.

- object
  - `id` string, required — The canonical profile ID.
  - `message` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — This error indicates that you have sent too many requests to the API. You should retry according to the `Retry-After` response header.
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/twilio/apis/memory-v1.md) · [All operations](https://skmtc.net/twilio/apis/memory-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/memory-v1/versions/1cfcc8fb9f19/schema)