Profile

Bulk Upsert Profiles

Changed on Nov 5, 2026

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

Base URL
https://memory.twilio.com
Auth
HTTP basic

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

Confirmation message for the operation.

operationIdstring

The ID of an asynchronous profile domain operation.

createdAtstring date-time

ISO 8601 timestamp when the operation was created.

statusUrlstring

URL to query the operation status.

Example response

{
  "message": "Events accepted for processing.",
  "operationId": "mem_profileop_00000000000000000000000000",
  "createdAt": "2023-08-15T14:25:00Z",
  "statusUrl": "/v1/ProfileOperations/mem_profilesbulkop_00000000000000000000000000"
}

Changes

Nov 5, 2026v17d598045f017 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
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