Bulk import Insight data

put

https://{region}-api.dotdigital.com/insightData/v3/import

Imports a batch of Insight data records into a collection and upserts them.

Body Params

Insight data data records to be imported

collectionName

string

required

length ≤ 255

Name of the Insight data collection

collectionScope

string

enum

required

The scope the collection applies to, either account level or contact level

Allowed:

collectionType

string

enum

required

Type of data the collection holds; custom denotes your custom data.

records

array of objects

required

length ≥ 1

The Insight data records for the collection

records*

An Insight data record

contactIdentity

object

If targeting a contact scoped collection you must specify the contact that owns this record

key

string

required

The unique key for the record

json

object

required

Headers

x-ddg-integration-token

string

If you are a partner of Dotdigital and have a verified integration then include your integration tracking token here.

Responses

401

Unauthorized

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

202Import processing

400Bad request