Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Adobe Campaign Data Management API

Write, update, and delete data records using the xtk:session#Write method. Supports insert, insertOrUpdate, update, and delete operations via the _operation attribute.

Adobe Campaign Data Management API is one of 20 APIs that Adobe Campaign publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Data Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and an AsyncAPI specification.

This API exposes 2 operations across 2 paths, and defines 4 schemas. It is described by OpenAPI 3.1.0, at version 8.0.0.

Requests are made against a single base URL, https://{instance}.campaign.adobe.com.

2 operations 2 paths 4 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
8.0.0
Base URL
https://mc.adobe.io/{ORGANIZATION}/campaign
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Adobe Campaign Data Management API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Security-Token (SessionToken).

  • SessionToken — Security token obtained from xtk:sessionLogon. Must be passed alongside the session token cookie (sessiontoken) on all authenticated requests. Tokens have a 24…

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

Data Management 2

Write, update, and delete data records using the xtk:sessionWrite method. Supports insert, insertOrUpdate, update, and delete operations via the operation attribute.

POST
/nl/jsp/soaprouter.jsp/xtk-session/Write
Adobe Campaign Write Data Records
sessionWrite 1 param body → 200500
POST
/nl/jsp/soaprouter.jsp/xtk-session/WriteCollection
Adobe Campaign Write Multiple Data Records
sessionWriteCollection 1 param body → 200500

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are SOAPFault (3 properties), WriteCollectionRequest (1 property), WriteResponse (1 property), WriteRequest (1 property). Each schema is shown below with its type and property counts.

WriteRequest
object
SOAP envelope containing an entity element for the target schema with attribute values and an operation attribute controlling the write behavior.
1 property
WriteResponse
object
SOAP response confirming the write operation. Returns the primary key of the affected record for insert operations.
1 property
SOAPFault
object
SOAP fault response indicating an error during operation processing.
3 properties
WriteCollectionRequest
object
SOAP envelope containing a collection of entity elements for batch write operations. Each entity can specify its own operation.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

adobe-campaign-data-management-api-openapi.yml Raw ↑

Other APIs Adobe Campaign publishes across the network.

Adobe Campaign Classic JavaScript SDK
Adobe I/O Campaign Standard SDK
Adobe Experience Platform Mobile SDK - Campaign Extensions
Adobe Campaign Custom Resources API
Adobe Campaign Delivery API
Adobe Campaign Marketing History API
Adobe Campaign Metadata API
Adobe Campaign Organizational Units API
Adobe Campaign Privacy API
Adobe Campaign ProfileAndServices API
Adobe Campaign Profiles API
Adobe Campaign Query Definition API