This API is used to initiate a file import into the FDP. It creates a pending file import entry, which waits for the corresponding file to be uploaded to our cloud storage system.

The response will include metadata related to the file import, along with a URL enabling direct upload access to our cloud storage system. This URL is secured with a short-lived access token, valid for up to 5 minutes, and supports file uploads of up to 1000 MB.

Uploading a file

Using the URL provided in the import file response, a file can be uploaded directly to our cloud storage system. This upload will automatically trigger the file import process.

Example cURL

curl -X PUT -H 'Content-Type: text/csv' -T "/path/to/file" "presigned URL"

File Format

The file must be in CSV or ZIP format and must include an email_address field.

File Limits

Files are limited to a maximum size of 1000 MB. If your files exceed this size, please divide them into smaller files and import each one separately.

Mapping

Import file requests must include a mapping structure that defines how the source file data maps to FDP data. Any fields not specified in the mapping structure will be ignored during the file import process and will not be included in the FDP.

Example Mapping

[
    {
        "index": 1,
        "targetFieldName": "firstName"
    },
    {
        "index": 2,
        "targetFieldName": "lastName"
    },
    {
        "index": 3,
        "targetFieldName": "email"
    }
]

Example Imported File