Skip to main content

StackAdapt

StackAdapt is a programmatic advertising platform (DSP) for running native, display, video, CTV, audio, and digital out-of-home campaigns. The StackAdapt connector reads advertisers, campaign groups, campaigns, ads, custom audience segments, the audience catalogue, pixels, and delivery statistics (impressions, clicks, spend, and conversions) by date range through StackAdapt's GraphQL API. It is read-only.

StackAdapt icon

Power end-to-end data operations for your StackAdapt API with Nexla. Our bi-directional StackAdapt connector is purpose-built for StackAdapt, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to StackAdapt or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your StackAdapt workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites​

Nexla connects to StackAdapt's GraphQL API with a GraphQL API token. StackAdapt issues these tokens on request; there is no self-service page for them.

  1. You need an active StackAdapt advertiser, agency, or partner account.

  2. Ask your StackAdapt account manager or StackAdapt support for a GraphQL API token. See StackAdapt's developer documentation for details.

  3. Store the token securely.

The API key shown in the StackAdapt platform is for StackAdapt's older REST API and does not work with this connector. Use a GraphQL API token.

A token can be limited to some advertisers. The templates return data only for the advertisers that the token can access; use Get API Token Info to check which token a credential holds and when it expires.

App partners can ask StackAdapt for a sandbox token. A sandbox token works only with the Sandbox environment, and a production token only with Production.

Authenticate​

Credentials required​

Bearer token for the StackAdapt GraphQL API. Saving the credential runs a read-only tokenInfo query to check the token.

FieldRequiredSecretDescription
GraphQL API TokenYesYesStackAdapt GraphQL API token, sent as 'Authorization: Bearer <token>'. Issued on request by StackAdapt (account manager or support). The legacy REST key from the StackAdapt UI does not work here.
EnvironmentYesNoGraphQL endpoint. Production (api.stackadapt.com) for live accounts; Sandbox for app-partner sandbox tokens. A token only works in the environment that issued it. Allowed values: Production (api.stackadapt.com); Sandbox (sandbox.stackadapt.com)

Create a credential in Nexla​

  1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Paste your token into the GraphQL API Token field. Nexla sends it in the Authorization header as Bearer <token>.

    The API token is sensitive and should be kept secure. If it is exposed, ask StackAdapt to revoke it and issue a new one, and update this credential.

  4. Select the Environment that issued the token: Production (api.stackadapt.com) for live accounts, or Sandbox (sandbox.stackadapt.com) for an app-partner sandbox token.

  5. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Nexla tests the credential by reading the token's name, creation date, and expiry date (the tokenInfo query).

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the StackAdapt connector tile, then select the credential that will be used to connect to your StackAdapt account, and click Next; or, create a new StackAdapt credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common StackAdapt endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below, grouped by area.

Every template sends a read-only GraphQL query to StackAdapt's GraphQL endpoint for the selected environment. StackAdapt's GraphQL reference is at docs.stackadapt.com/graphql and requires a StackAdapt sign-in.

Templates that need an ID, such as an advertiser or campaign ID, read that one object; use the matching list template to find the ID. Settings named Advertiser IDs, Campaign Group IDs, or Campaign IDs are optional filters: leave them at null for no filter, or enter a JSON list of IDs such as ["123","456"] (a single ID such as 123 also works). Archived settings take false (active only, the default), true (archived only), or null (both).

Advertisers, campaigns, and ads​

List Advertisers

Lists every advertiser the token can access, with ID, name, description, archived flag, deal IDs, and domain exclusions. Use it first to find the advertiser IDs that other templates take.

  • Runs the advertisers GraphQL query.
  • Results are paged automatically, 100 records per page.
  • Archived (required; default false): Which advertisers to return: false = active only (default), true = archived only, null = both. Options: Active only (false), Archived only (true), Both (null).

Get Advertiser

Returns one advertiser by ID, with name, description, archived flag, deal IDs, and domain exclusions.

  • Runs the advertiser GraphQL query.
  • Advertiser ID (required): The StackAdapt ID. Use the matching list template to find it.

List Campaign Groups

Lists campaign groups (also called line items or insertion orders), with status, budget type, revenue settings, advertiser, and flights (dates, lifetime budget, and daily budget).

  • Runs the campaignGroups GraphQL query.
  • Results are paged automatically, 100 records per page.
  • Archived (required; default false): Which campaign groups to return: false = active only (default), true = archived only, null = both. Options: Active only (false), Archived only (true), Both (null).
  • Advertiser IDs (optional; default null): Advertiser IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all advertisers the token can access.

Get Campaign Group

Returns one campaign group by ID, with status, budget type, revenue settings, advertiser, and flights.

  • Runs the campaignGroup GraphQL query. Returns up to 50 flights.
  • Campaign Group ID (required): The StackAdapt ID. Use the matching list template to find it.

List Campaigns

Lists campaigns with channel, goal, state and status, advertiser, campaign group, and flights (dates, budget, bid, and goal).

  • Runs the campaigns GraphQL query.
  • Results are paged automatically, 100 records per page.
  • Archived (required; default false): Which campaigns to return: false = active only (default), true = archived only, null = both. Options: Active only (false), Archived only (true), Both (null).
  • Advertiser IDs (optional; default null): Advertiser IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all advertisers the token can access.
  • Campaign Group IDs (optional; default null): Campaign group IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all campaign groups the token can access.

Get Campaign

Returns one campaign by ID, with channel, goal, state and status, advertiser, campaign group, and flights.

  • Runs the campaign GraphQL query. Returns up to 50 flights.
  • Campaign ID (required): The StackAdapt ID. Use the matching list template to find it.

List Ads (Creatives)

Lists ads (creatives) with name, brand name, channel, creative size, click URL, state and status, paused and rejected flags, and parent campaign.

  • Runs the ads GraphQL query.
  • Results are paged automatically, 100 records per page.
  • Archived (required; default false): Which ads to return: false = active only (default), true = archived only, null = both. Options: Active only (false), Archived only (true), Both (null).
  • Advertiser IDs (optional; default null): Advertiser IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all advertisers the token can access.
  • Campaign IDs (optional; default null): Campaign IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all campaigns the token can access.

Delivery statistics​

Delivery dates use the yyyy-MM-dd format and the account time zone, and default to the last 30 days ({now-30} to {now}). Keep daily reports to about 93 days and weekly reports to about a year per run; longer ranges can take longer to build.

Get Advertiser Delivery Stats

Returns delivery and performance statistics per advertiser for a date range.

  • Runs the advertiserDelivery GraphQL query.
  • StackAdapt builds delivery reports asynchronously. Nexla first requests the report and re-checks it every 5 seconds, up to 30 times, until it is ready, then reads every row, 100 rows per page.
  • Start Date (required; default {now-30}): First day of the report, in the account time zone.
  • End Date (required; default {now}): Last day of the report (inclusive).
  • Granularity (required; default DAILY): The time bucket for each row. TOTAL returns one row per entity for the whole date range. Options: Daily (DAILY), Weekly (WEEKLY), Monthly (MONTHLY), Total (TOTAL), Hourly (HOURLY).
  • Data Type (required; default TABLE): The StackAdapt delivery view: TABLE (rows per entity, the default) or GRAPH (time series). Options: Table (one row per entity and period) (TABLE), Graph (time series) (GRAPH).
  • Advertiser IDs (optional; default null): Advertiser IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all advertisers the token can access.
  • Each row has the period (granularity type and start and end time) and metrics: impressions, clicks, CTR, cost, eCPM, eCPC, conversions, conversion rate, eCPA, conversion revenue, ROAS, unique impressions, frequency, engagements, and video starts and completions.

Get Campaign Group Delivery Stats

Returns delivery and performance statistics per campaign group for a date range.

  • Runs the campaignGroupDelivery GraphQL query.
  • StackAdapt builds delivery reports asynchronously. Nexla first requests the report and re-checks it every 5 seconds, up to 30 times, until it is ready, then reads every row, 100 rows per page.
  • Start Date (required; default {now-30}): First day of the report, in the account time zone.
  • End Date (required; default {now}): Last day of the report (inclusive).
  • Granularity (required; default DAILY): The time bucket for each row. TOTAL returns one row per entity for the whole date range. Options: Daily (DAILY), Weekly (WEEKLY), Monthly (MONTHLY), Total (TOTAL), Hourly (HOURLY).
  • Data Type (required; default TABLE): The StackAdapt delivery view: TABLE (rows per entity, the default) or GRAPH (time series). Options: Table (one row per entity and period) (TABLE), Graph (time series) (GRAPH).
  • Advertiser IDs (optional; default null): Advertiser IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all advertisers the token can access.
  • Campaign Group IDs (optional; default null): Campaign group IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all campaign groups the token can access.
  • Each row has the period (granularity type and start and end time) and metrics: impressions, clicks, CTR, cost, eCPM, eCPC, conversions, conversion rate, eCPA, conversion revenue, ROAS, unique impressions, frequency, engagements, and video starts and completions.

Get Campaign Delivery Stats

Returns delivery and performance statistics per campaign for a date range.

  • Runs the campaignDelivery GraphQL query.
  • StackAdapt builds delivery reports asynchronously. Nexla first requests the report and re-checks it every 5 seconds, up to 30 times, until it is ready, then reads every row, 100 rows per page.
  • Start Date (required; default {now-30}): First day of the report, in the account time zone.
  • End Date (required; default {now}): Last day of the report (inclusive).
  • Granularity (required; default DAILY): The time bucket for each row. TOTAL returns one row per entity for the whole date range. Options: Daily (DAILY), Weekly (WEEKLY), Monthly (MONTHLY), Total (TOTAL), Hourly (HOURLY).
  • Data Type (required; default TABLE): The StackAdapt delivery view: TABLE (rows per entity, the default) or GRAPH (time series). Options: Table (one row per entity and period) (TABLE), Graph (time series) (GRAPH).
  • Advertiser IDs (optional; default null): Advertiser IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all advertisers the token can access.
  • Campaign Group IDs (optional; default null): Campaign group IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all campaign groups the token can access.
  • Campaign IDs (optional; default null): Campaign IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all campaigns the token can access.
  • Each row has the period (granularity type and start and end time) and metrics: impressions, clicks, CTR, cost, eCPM, eCPC, conversions, conversion rate, eCPA, conversion revenue, ROAS, unique impressions, frequency, engagements, and video starts and completions.

Get Ad Delivery Stats

Returns delivery and performance statistics per ad (creative), with its campaign, for a date range.

  • Runs the adDelivery GraphQL query.
  • StackAdapt builds delivery reports asynchronously. Nexla first requests the report and re-checks it every 5 seconds, up to 30 times, until it is ready, then reads every row, 100 rows per page.
  • Start Date (required; default {now-30}): First day of the report, in the account time zone.
  • End Date (required; default {now}): Last day of the report (inclusive).
  • Granularity (required; default DAILY): The time bucket for each row. TOTAL returns one row per entity for the whole date range. Options: Daily (DAILY), Weekly (WEEKLY), Monthly (MONTHLY), Total (TOTAL), Hourly (HOURLY).
  • Data Type (required; default TABLE): The StackAdapt delivery view: TABLE (rows per entity, the default) or GRAPH (time series). Options: Table (one row per entity and period) (TABLE), Graph (time series) (GRAPH).
  • Advertiser IDs (optional; default null): Advertiser IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all advertisers the token can access.
  • Campaign IDs (optional; default null): Campaign IDs to filter on, as a JSON list such as ["123","456"]. Leave null for all campaigns the token can access.
  • Each row has the period (granularity type and start and end time) and metrics: impressions, clicks, CTR, cost, eCPM, eCPC, conversions, conversion rate, eCPA, conversion revenue, ROAS, unique impressions, frequency, engagements, and video starts and completions.

Audiences and pixels​

List Custom Segments (Audiences)

Lists the custom audience segments in your account, with ID, name, description, active flag, size, device ID size, and creation date. StackAdapt's public segments are not included.

  • Runs the customSegments GraphQL query.
  • Results are paged automatically, 100 records per page.

Get Audience Catalogue

Returns StackAdapt's catalogue of targetable demographic and interest segments as two JSON trees. Use it to look up segment names and IDs for audience targeting.

  • Runs the audiences GraphQL query.

List Pixels (Conversion Trackers)

Lists the pixels in your account of one type: conversion trackers (the default), retargeting, or lookalike pixels, with ID, name, description, unique key, and advertiser restrictions.

  • Runs the account.pixels GraphQL query.
  • Results are paged automatically, 100 records per page.
  • Pixel Type (required; default CONVERSION): Which pixels to list: CONVERSION (conversion trackers, default), RETARGETING, LOOKALIKE or COMBINED_LOOKALIKE. Options: Conversion (CONVERSION), Retargeting (RETARGETING), Lookalike (LOOKALIKE), Combined lookalike (COMBINED_LOOKALIKE).

Account​

Get API Token Info

Returns the name, creation date, and expiry date of the API token that the credential holds. Use it to check which token a credential uses and when it expires.

  • Runs the tokenInfo GraphQL query.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

StackAdapt data sources can also be manually configured to ingest data from any valid StackAdapt API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

StackAdapt's GraphQL endpoint is https://api.stackadapt.com/graphql (production) or https://sandbox.stackadapt.com/public/graphql (sandbox). Send POST requests with a JSON body containing query and variables; the credential adds the Authorization: Bearer header.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new StackAdapt data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.