Request profile import (version 2) (in development)

In development

This APSIS One API feature is in development and it's not meant to be used yet

Request profile import

Request a profile import into APSIS One.

Import is an asynchronous operation. Once it's been requested you'll receive a response that contains the file upload URL with embedded credentials and the expiration details.

Upload your import file using that URL. APSIS One API profile import supports CSV files (content type text/csv).

In its requests and responses, APSIS One API supports date and time formatted as ISO 8601 referred to as date-time in RFC 3339, section 5.6 in the UTC variant.

Import files support more date formats as described in this Help Center article. However these dates will be converted to a format corresponding to the type of the attribute the import file column is mapped to. Read more about attribute types in this Help Center article.

Once you've uploaded the file you can check the status using the corresponding GET /audience/sections/{section_discriminator}/imports/{import_id} endpoint.

The manage_subscriptions flag must be true on the keyspace used or HTTP 403 Forbidden response status code is returned.

All the attributes and tags you are trying to set during the import need to be allowed to WRITE through the selected keyspace. If any of them is not, HTTP 403 Forbidden response status code is returned.


The maximum import file size is 50 MB. Split your import into multiple files and import requests to mitigate this.

Pending import count limit. If reached, HTTP 429 Too Many Requests is returned.

The import file considerations are the same when importing via APSIS One as when importing via this API. They've been described in this Knowledge Base article.

Understanding import failures

For every import, we're generating a report that contains statistics and detailed information about the import errors. See this Knowledge Base article.

Version 2

This version of Profile Import feature is RECOMMENDED for accounts with channel-specific topics enabled. It provides a simplified request model that is more compatible with this scenario.

Works with keyspaces that have manage_subscriptions flag set, otherwise the HTTP 403 Forbidden status code is returned.

Keyspaces and consents are now independent. You are able to create profiles (and profile keys) in a keyspace of your choice (e.g. CRM) and at the same time create consents for these profiles to the topics that are specific to channels not related to that keyspace (e.g. email or SMS).

Profiles (and profile keys) are created in a single keyspace. Profile merge is not supported.

Inside consent_mappings, the channel is inferred from the topic provided in the topic_discriminator parameter.

More information

Step by step guide