Sign in

v3

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

Import Profiles

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 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://unified-profiles-csv-upload-stage-us-east-1.s3.amazonaws.com/object.txt?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Signature=vjbyNxybdZaMmLa%2ByT372YEAiv4%3D&Expires=1741978496"
}