v3

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

Bulk Upsert Profiles

Create or update up to 1000 profiles in a single asynchronous batch. Each profile body follows the same structure as single profile creation. If a profile already exists its traits are merged (new keys added, existing keys overwritten). Large batches may take time to process; the 202 response indicates the batch has been accepted. Monitor downstream telemetry or audit logs to confirm completion.

put/v1/Stores/{storeId}/Profiles/Bulk

Request body

Example request

{
  "profiles": [
    {
      "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

Profiles batch accepted.

messagestring required

Example response

{
  "message": "Profile batch accepted for processing."
}