---
schema_version: "1"
id: 358d3fda8f27ab30a7768a6b21801e9596df1b67d0aaf3a73e6f9516db12a9ce
title: Adform API Connector
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/mcidp_data_streams_api_connect_adform.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mcidp_data_streams_api_connect_adform.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 6a95e57b826786da196b1eb2985f547b990d1484b011b6f92abda1aa25255a56
description: The Adform API connector retrieves Leads data. The data is aggregated and can only be seen at the campaign level.
products:
  - Marketing
  - Marketing Cloud Intelligence
release: "264"
---
# Adform API Connector

The Adform API connector retrieves Leads data. The data is aggregated and can only be seen at the campaign level.

You might see some discrepancies in the Media Cost data, due to a difference between the API report and the report sent to the user.

- **Channel**: Display
- **Cost Data lagging**: 1 Day back

## Prerequisites

- A valid Adform username and password with user level API access enabled. To enable API access, go to your user profile screen and check the 'External API' checkbox
- If your username and password don’t grant you access to the API, contact your Adform representative.
- Adform has password complexity requirements for API users. If these requirements aren’t fulfilled, an ‘Invalid credentials’ error appears and you won’t be able to create the OAuth.
- Password requirements:
    - Minimum 6 symbols
    - Upper and lower case letters
    - Numbers
    - At least 1 Special character

## Additional Details

- The maximum date range accessible through the API is 365 days from today. For example, last year's data is available through the Adform API.
- If the same credentials used to set this API are used in an additional Workspace, make sure to set the Level to 'Account' through the Authentication edit window.

## Extended Properties

- **Cost Type** – Set the Cost type to match the Cost Type set in your Adform account. You can see the cost type set in your Adform account be clicking the Cost column.
- **Get Banner Data** – This checkbox pulls Creative Level Dimensions from Adform. After choosing this checkbox, the following Dimensions are pulled to the Data Stream:
    - Creative Key (AdID)
    - Creative Name (AdName)
    - Creative Category (bannerFormat)
    - Creative Format (AdType)
    - Creative Custom Attribute 01 (AdWidthxAdHeight)
    - Creative Custom Attribute 02 (AdFileSize)
- **Get Conversion Data** – This checkbox pulls Conversion Data to the ‘Conversion Tag’ Bucket. The following Dimensions and Measurements are pulled to the Data Stream:
    - Conversion Tag Key (pageID)
    - Conversion Tag Name (page)
    - Total Conversions (conversions)
    - Post Impression Conversions (PostImpressionLeads)
    - Post Click Conversions (PostClickLeads)
    - Post Impression Revenue (PostImpressionSales)