Profile

Import Profiles

Changed on Aug 11, 2026

Initiate a profile import by requesting a pre-signed upload URL and an associated importId. Upload your CSV to the returned URL (single PUT). Query the import status endpoint to track processing progress. This endpoint creates the import task and allocates resources for subsequent ingestion.

post/v1/Stores/{storeId}/Profiles/Imports

Request

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

Request body

filenamestring required

The name of the file to generate a presigned URL

fileSizeinteger required

The size of the file in bytes (1 byte to 100 MiB)

Example request

{
  "columnMappings": [
    {
      "columnName": "first_name",
      "traitGroup": "Contact",
      "traitName": "firstName"
    }
  ]
}

Response

Import task created.

importIdstring required

ID of the import task.

urlstring required

Pre-signed URL to upload the CSV via a single PUT request.

Example response

{
  "importId": "mem_import_00000000000000000000000000",
  "url": "https://cell-1.us-east-1.profiles-import.s3.us-east-1.amazonaws.com/AC0001/store_0001/import_0001/profiles.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA...&X-Amz-Date=20260101T000000Z&X-Amz-Expires=1800&X-Amz-SignedHeaders=host&X-Amz-Signature=abcd1234..."
}

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