How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Dotdigital

Dotdigital Insight Data API

The InsightData API from Dotdigital — 17 operation(s) for insightdata.

Documentation Provider Profile APIs.io OpenAPI GitHub

Dotdigital Insight Data API is one of 63 APIs that Dotdigital publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include InsightData. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 22 operations across 17 paths, and defines 33 schemas. It is described by OpenAPI 3.2.0, at version 3.3.1.

Requests are made against a single base URL, https://{region}-api.dotdigital.com.

22 operations 17 paths 33 schemas 7 DELETE11 GET1 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.3.1
Base URL
https://r1-api.dotdigital.com/v2
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

Dotdigital Insight Data API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

Paths & Operations 22

Across 17 paths, the API surfaces 22 operations — 7 DELETE, 11 GET, 1 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

InsightData 22
PUT
/insightData/v3/import
Bulk imports Insight data
importInsightData 1 param body → 202400401
GET
/insightData/v3/import/{importId}
Retrieve the status of a Insight data import request
getImportStatus 2 params → 200400401404
GET
/insightData/v3/async/{jobId}
Retrieve the status of an asynchronous request
getAsyncStatus 2 params → 200400401404
GET
/insightData/v3/collections
Lists all Insight data collections
getAllInsightDataCollections 1 param → 200401
POST
/insightData/v3/collections/{collectionName}
Creates an Insight data collection
postCreateInsightDataCollection 4 params → 200201400401412
DELETE
/insightData/v3/collections/{collectionName}
Deletes an Insight data collection
delInsightDataCollection 2 params → 202400401404
DELETE
/insightData/v3/accounts/{collectionName}/deleteRecords
Deletes multiple records from an account scoped Insight Data collection.
delAccountInsightDataRecords 2 params body → 200400401404
DELETE
/insightData/v3/collections/{collectionName}/empty
Empties an Insight data collection
delEmptyAnyInsightDataCollection 2 params → 202400401404
GET
/insightData/v3/collections/{collectionName}/schema
Gets the JSON schema for an Insight data collection
getInsightDataCollectionSchema 2 params → 200400401404
GET
/insightData/v3/account
List account Insight data collections
getAccountInsightDataCollections 1 param → 200401
GET
/insightData/v3/account/{collectionName}
Retrieves records from an accounts Insight data collection
getAccountInsightData 5 params → 200400401404
GET
/insightData/v3/account/{collectionName}/{recordId}
Retrieve single record from an account Insight data collection
getAccountInsightDataRecord 3 params → 200400401404
PUT
/insightData/v3/account/{collectionName}/{recordId}
Upsert record into an account Insight data collection
putAccountInsightDataRecord 3 params body → 201204400401404
DELETE
/insightData/v3/account/{collectionName}/{recordId}
Delete record from an account Insight data collection
delAccountInsightDataRecord 3 params → 204400401404
GET
/insightData/v3/contacts/{collectionName}
Retrieve data for contact-scoped Insight data collection
getAllContactsInsightData 5 params → 200400401404
GET
/insightData/v3/contacts/{identifier}/{value}
List Insight data collections for a contact
getContactInsightDataCollections 3 params → 200400401404
GET
/insightData/v3/contacts/{identifier}/{value}/{collectionName}
Retrieve records for a contact from Insight data collection
getContactInsightData 7 params → 200400401404
DELETE
/insightData/v3/contacts/{identifier}/{value}/{collectionName}/deleteRecords
Deletes multiple records from an contact scoped Insight Data collection.
delContactInsightDataRecords 3 params body → 200400401404
DELETE
/insightData/v3/contacts/{identifier}/{value}/{collectionName}/empty
Empty Insight data collection for a contact
delEmptyContactInsightDataCollection 4 params → 202400401404
GET
/insightData/v3/contacts/{identifier}/{value}/{collectionName}/{recordId}
Retrieve Insight data record for a contact
getContactInsightDataRecord 5 params → 200400401404
PUT
/insightData/v3/contacts/{identifier}/{value}/{collectionName}/{recordId}
Upsert record into Insight data collection for a contact
putContactInsightDataRecord 5 params body → 201204400401404
DELETE
/insightData/v3/contacts/{identifier}/{value}/{collectionName}/{recordId}
Delete record from Insight data collection for a contact
delContactInsightDataRecord 5 params → 204400401404

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are paginationLinks (5 properties), inline_response_200 (5 properties), collectionSummary (4 properties), v3_import_body (4 properties). Each schema is shown below with its type and property counts.

paginationLinks
object
Pagination links
5 properties 2 required
inline_response_200_2
object
The results of the deletion.
2 properties 2 required
paginationLinks_last
object
Details for accessing the last pages worth of data
2 properties 2 required
collectionName_deleteRecords_body
object
1 property 1 required
collectionSummary
object
An Insight data collection summary
4 properties 3 required
inline_response_202
object
1 property
errorResponse_details
object
2 properties 2 required
collectionType
string
Type of data the collection holds; custom denotes your custom data.
v3_import_body
object
4 properties 4 required
collectionName
string
Name of the Insight data collection
inline_response_200_4
object
2 properties 2 required
inline_response_200_summary
object
3 properties
returnedInsightRecord
An Insight data record
asyncJobId
object
1 property 1 required
inline_response_200_1_summary
object
3 properties
inline_response_200_3
object
An Insight data collection summary
3 properties 3 required
inline_response_200
object
5 properties 2 required
collectionOwner
object
2 properties 1 required
paginationLinks_next
object
Details for accessing the next pages worth of data
2 properties 2 required
inline_response_200_5
object
2 properties 2 required
contactIdentifier
object
2 properties 2 required
contactId
integer
Immutable unique identifier for the contact
inline_response_200_6
object
2 properties 2 required
inline_response_200_1
object
4 properties 2 required
errorResponse
object
3 properties 2 required
collectionName_deleteRecords_body_1
object
1 property 1 required
collectionScope
string
The scope the collection applies to, either account level or contact level
upsertInsightRecord
An Insight data record to be upserted
paginationLinks_first
object
Details for accessing the first page worth of data
2 properties 2 required
paginationLinks_self
object
Details for accessing this data page via pagination
2 properties 2 required
inline_response_200_2_summary
object
3 properties
insightRecord
object
An Insight data record
2 properties 2 required
paginationLinks_prev
object
Details for accessing the previous pagea worth of data
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

dotdigital-insightdata-api-openapi.yml Raw ↑

Other APIs Dotdigital publishes across the network.

Dotdigital Marketing Developer Hub MCP Server
AE Profile APIs.io
Dotdigital Accounts and Utilities API
AE Profile APIs.io
Dotdigital API Account API
AE Profile APIs.io
Dotdigital API Address Book API
AE Profile APIs.io
Dotdigital API Campaign API
AE Profile APIs.io
Dotdigital API Campaign From Address API
AE Profile APIs.io
Dotdigital API Campaign Reporting API
AE Profile APIs.io
Dotdigital API Campaign Send API
AE Profile APIs.io
Dotdigital API Contact API
AE Profile APIs.io
Dotdigital API Contact Import API
AE Profile APIs.io
Dotdigital API Data Field API
AE Profile APIs.io
Dotdigital API Document API
AE Profile APIs.io
#InsightData
← Back to D APIs
API Details
ID
dotdigital:dotdigital-insightdata-api
Base URL
https://r1-api.dotdigital.com/v2
Docs
https://marketing.developer.dotdigital.com/docs/getting-started-with-the-api
Provider
Dotdigital
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=dotdigital-insightdata-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/dotdigital-insightdata-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Dotdigital Insight Data API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.