Getting Started with the Adobe Target Delivery API

Last update: May 12, 2026

Topics:
Implementation

CREATED FOR:

Developer

IMPORTANT

This guide applies to at.js and direct server-side implementations that call the Target Delivery API directly. If you are implementing Target using the Adobe Experience Platform Web SDK, use the Interact API (sendEvent command over the Experience Platform Edge Network) instead. See Adobe Experience Platform Web SDK for more information.

A Target Delivery API call looks like this:

curl -X POST \
  'https://`clientCode`.tt.omtrdc.net/rest/v1/delivery?client=`clientCode`&sessionId=d359234570e04f14e1faeeba02d6ab9914e' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
      "context": {
        "channel": "web",
        "browser" : {
          "host" : "demo"
        },
        "address" : {
          "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
        },
        "screen" : {
          "width" : 1200,
          "height": 1400
        }
      },
        "execute": {
        "mboxes" : [
          {
            "name" : "homepage",
            "index" : 1
          }
        ]
      }
    }'

The clientCode can be retrieved from the Target UI by navigating to Administration > Implementation.

Before making a Target Delivery API call, follow these steps to ensure a response contains the relevant experience to show end users:

Create a Target activity (A/B, XT, AP or Recommendations) using the Form-Based Composer or the Visual Experience Composer.
Use the Delivery API to get a response for the mboxes used in the Target activity created in Step 2.
Present the experience to the visitor.

recommendation-more-help

target-dev-help-dev