---
canonical_url: "https://docs.composio.dev/toolkits/adroll"
markdown_url: "https://docs.composio.dev/toolkits/adroll.md"
product: "platform"
version: null
last_updated: null
---

# AdRoll

AdRoll is a digital marketing platform for managing advertising campaigns, audiences, account-based marketing, and performance reporting.

- **Category:** marketing
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 51
- **Triggers:** 0
- **Slug:** `ADROLL`
- **Version:** 00000000_00

## Tools

### Create Ad

**Slug:** `ADROLL_CREATE_AD`

Create an ad for an advertisable, optionally creating nested assets that do not have EIDs in the same operation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Display name of the ad; AdRoll requires fewer than 64 characters. |
| `type` | string ("facebook" | "native" | "web" | "html5" | "personalized" | "ad_network" | "linkedin" | "pinterest" | "tiktok" | "flash") | No | Type of the ad. |
| `width` | integer | No | Ad width in pixels. |
| `assets` | array | No | Assets for the ad. Assets without an EID are created atomically with the ad. |
| `height` | integer | No | Ad height in pixels. |
| `status` | string | No | Initial status of the ad. |
| `subtype` | string ("LEADERBOARD" | "MEDIUM_RECTANGLE" | "WIDE_SKYSCRAPER" | "MOBILE_LEADERBOARD" | "LARGE_RECTANGLE" | "BILLBOARD" | "BANNER" | "SQUARE" | "SMALL_SQUARE" | "SKYSCRAPER" | "RECTANGLE" | "RECTANGLE_2" | "VERTICAL_BANNER" | "BUTTON" | "BUTTON_2" | "S300X100" | "S645X60" | "HALF_PAGE" | "HALF_BANNER" | "RECTANGULAR_BUTTON" | "MICRO_BANNER" | "SINGLE" | "CAROUSEL" | "VIDEO" | "NATIVE_AD_600x500" | "NATIVE_AD_600x315" | "NATIVE_AD_600x600" | "EMAIL_M_BANNER" | "EMAIL_BANNER" | "MAX_VIDEO" | "IDEA_PIN") | No | Subtype of the ad. |
| `read_only` | boolean | No | Whether the ad should be read-only. |
| `is_dynamic` | boolean | No | Whether the ad is dynamic. |
| `advertisable` | string | Yes | EID of the advertisable that will own the ad. |
| `ad_parameters` | array | No | Parameters for a dynamic ad. |
| `do_not_forward` | boolean | No | Whether AdRoll should avoid forwarding the ad. |
| `multiple_products` | integer | No | Zero for a single product and greater than zero for multiple products. |
| `is_multi_share_optimized` | boolean | No | Whether the ad is multi-share optimized. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Adgroup

**Slug:** `ADROLL_CREATE_ADGROUP`

Create a web-retargeting adgroup under a Campaign v3 campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `adgroup` | object | Yes | Exact Campaign v3 web-retargeting adgroup creation body. |
| `campaign_id` | string | Yes | Campaign EID under which to create the adgroup. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Advertisable

**Slug:** `ADROLL_CREATE_ADVERTISABLE`

Create an advertisable in an organization owned by the connected account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Advertisable website URL. |
| `name` | string | Yes | Name of the new advertisable. |
| `country_code` | string | No | ISO 3166-1 alpha-2 country code; omission applies AdRoll's most conservative data policy. |
| `organization` | string | Yes | EID of the organization that will own the advertisable; the connected account must own it. |
| `set_as_default` | boolean | No | Whether to make this the connected user's default advertisable; defaults to false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Asset

**Slug:** `ADROLL_CREATE_ASSET`

Create an asset. File content is passed exactly as a base64 string in the JSON request body.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | string | No | Base64-encoded image content sent as a JSON string. |
| `name` | string | No | Display name of the asset. |
| `type` | string ("text" | "image" | "video") | No | Type of the asset. |
| `subtype` | string ("url" | "display_url" | "title" | "call_to_action" | "link_description" | "message" | "impression_tracker" | "third_party_click_tracker" | "instagram_permalink_url" | "object_story_id" | "brand_name" | "utm_tracking" | "preview_url" | "html" | "ad_blocker_url" | "tracking_urls" | "ad_text" | "fallback_type" | "actor_id" | "display_name" | "ad" | "logo" | "placeholder" | "default") | No | Asset subtype. Choose a text-specific value for text, an image-specific value for images, or the video-specific value for video. |
| `description` | string | No | Description of the asset. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Campaign

**Slug:** `ADROLL_CREATE_CAMPAIGN`

Create a web-retargeting campaign under a Campaign v3 strategy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign` | object | Yes | Exact Campaign v3 web-retargeting campaign creation body. |
| `strategy_id` | string | Yes | Strategy EID under which to create the campaign. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Marketplace Mapping

**Slug:** `ADROLL_CREATE_MARKETPLACE`

Create a marketplace-to-merchant mapping. Both advertisables must be accessible and marketplace-enabled by AdRoll.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique merchant identifier within the marketplace. |
| `external_shop_id` | string | No | Merchant-owned identifier; must be unique for the same source advertisable. |
| `dest_advertisable` | string | Yes | EID of the merchant child advertisable. |
| `source_advertisable` | string | Yes | EID of the marketplace parent advertisable. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Rule

**Slug:** `ADROLL_CREATE_RULE`

Create a pixel rule. AdRoll may normalize the requested order; use the returned value as authoritative. CRM-data rules require a CSV containing at least 100 emails, but the provider does not document its exact file encoding and header contract.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional arbitrary rule name. |
| `type` | string ("c" | "s" | "p" | "b" | "l" | "u") | Yes | Rule type: c conversion, s segment, p prospect, b cart, l product list, or u product; it cannot be changed later. |
| `order` | integer | Yes | Requested priority hint within the pixel; lower numbers request higher priority. AdRoll may normalize this value, so use the returned order as authoritative. |
| `pixel` | string | Yes | EID of the pixel on which to create the rule. |
| `source` | string ("c" | "d" | "m") | No | Optional rule source: c cookie, d CRM data, or m mobile. |
| `pattern` | string | No | URL-matching expression for a URL rule. |
| `csv_file` | object | No | A file the caller hands IN. ``s3key`` is an S3/R2 reference (production) or a base64 ``data:`` URL (self-hosted ``FILE_BACKEND=base64``) — the ``FileStore`` knows which. Mirrors ``mercury/tools/files.py`` field-for-field. |
| `duration` | integer | No | Inactivity duration before a user is dropped from the rule. |
| `display_name` | string | No | Optional display name. |
| `match_method` | string | No | Match method. URL rules default to the provider-required url_match. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Segment

**Slug:** `ADROLL_CREATE_SEGMENT`

Create one audience segment for an advertiser and seed it with user identifiers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Human-readable segment name. |
| `users` | array | Yes | Initial user records to add. |
| `segment_type` | string ("crm" | "custom" | "impression" | "user_events" | "user_attributes" | "crosschannel_lal") | Yes | Provider segment type appropriate for the supplied users and use case. |
| `advertiser_id` | string | Yes | Advertiser EID that will own the segment. |
| `duration_days` | integer | Yes | Number of days, from 1 through 540, that members remain valid. |
| `is_conversion` | boolean | No | Whether this is a conversion segment. |
| `conversion_value` | number | No | Conversion value associated with a conversion segment. |
| `general_exclusion_type` | string ("customers" | "coworkers" | "competitors") | No | General-exclusion classification for an exclusion segment. |
| `salesforce_company_list_id` | string | No | Salesforce company-list ID referenced by the segment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Strategy

**Slug:** `ADROLL_CREATE_STRATEGY`

Create a Campaign v3 strategy under an advertisable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `strategy` | object | Yes | Exact Campaign v3 strategy creation body. |
| `advertisable_id` | string | Yes | Advertisable EID under which to create the strategy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Segment

**Slug:** `ADROLL_DELETE_SEGMENT`

Delete one existing audience segment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `segment_id` | string | Yes | EID of the segment to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Advertisable

**Slug:** `ADROLL_EDIT_ADVERTISABLE`

Edit the name, URL, or country code of an accessible advertisable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | New advertisable website URL. |
| `name` | string | No | New advertisable name. |
| `country_code` | string | No | New ISO 3166-1 alpha-2 country code. |
| `advertisable_id` | string | Yes | EID of the advertisable to edit. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Ad

**Slug:** `ADROLL_GET_AD`

Retrieve an ad by its Ad API resource eid, not its Reporting adroll_ad_eid.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eid` | string | Yes | Ad API resource EID returned as eid by CREATE_AD or LIST_ADS. Do not use adroll_ad_eid, which identifies the ad in Reporting GraphQL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Adgroup

**Slug:** `ADROLL_GET_ADGROUP`

Fetch one Campaign v3 adgroup by EID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `adgroup_id` | string | Yes | EID of the adgroup to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Adgroup Geotargets

**Slug:** `ADROLL_GET_ADGROUP_GEOTARGETS`

Fetch a Campaign v3 adgroup and return only its geotarget configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `adgroup_id` | string | Yes | EID of the adgroup whose geotargets to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Advertisable

**Slug:** `ADROLL_GET_ADVERTISABLE`

Fetch an advertisable by EID. AdRoll returns matching records as an array.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `advertisable_id` | string | Yes | EID of the advertisable to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Advertisable Pixel

**Slug:** `ADROLL_GET_ADVERTISABLE_PIXEL`

Fetch the active pixel for an accessible advertisable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `advertisable_id` | string | Yes | EID of the advertisable whose active pixel to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Asset

**Slug:** `ADROLL_GET_ASSET`

Retrieve an asset by its EID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eid` | string | Yes | EID of the asset to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign

**Slug:** `ADROLL_GET_CAMPAIGN`

Fetch one Campaign v3 campaign by advertisable and campaign EID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | EID of the campaign to retrieve. |
| `advertisable_id` | string | Yes | Advertisable EID owning the requested campaign. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Consent Banner

**Slug:** `ADROLL_GET_CONSENT_BANNER`

Fetch an advertisable's consent banner state. banner_declined is available only to advertisables in countries not covered by GDPR.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `advertisable_id` | string | Yes | EID of the advertisable whose consent banner configuration to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Organization

**Slug:** `ADROLL_GET_CURRENT_ORGANIZATION`

Return the connected account's current organization from Reporting GraphQL, including nested advertisables.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Marketplace Mappings

**Slug:** `ADROLL_GET_MARKETPLACE`

Retrieve marketplace mappings for a parent marketplace advertisable and child merchant advertisable. Both must be accessible and marketplace-enabled by AdRoll.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dest_advertisable` | string | Yes | EID of the merchant child advertisable. |
| `source_advertisable` | string | Yes | EID of the marketplace parent advertisable. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Pixel

**Slug:** `ADROLL_GET_PIXEL`

Fetch a pixel by EID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pixel_id` | string | Yes | EID of the pixel to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Pixel Segments

**Slug:** `ADROLL_GET_PIXEL_SEGMENTS`

Fetch segments associated with a pixel. Composio always sends page 0 when omitted; per_page remains omitted unless supplied, preserving the provider's unpaginated response behavior.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Current page number; Composio sends 0 when omitted. |
| `per_page` | string | No | Number of results per page; omit to request the unpaginated provider response. |
| `pixel_id` | string | Yes | EID of the pixel whose segments to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rule

**Slug:** `ADROLL_GET_RULE`

Fetch a rule by EID, including its generated segments when returned.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rule_id` | string | Yes | EID of the rule to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rule Segments

**Slug:** `ADROLL_GET_RULE_SEGMENTS`

Fetch the segments associated with a specific rule.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rule_id` | string | Yes | EID of the rule whose segments to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Segment

**Slug:** `ADROLL_GET_SEGMENT`

Return one audience segment, optionally including general-exclusion attributes or an inactive segment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `segment_id` | string | Yes | EID of the segment to retrieve. |
| `include_general_exclusion_attributes` | boolean | No | Whether to include general-exclusion attributes in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Strategy

**Slug:** `ADROLL_GET_STRATEGY`

Fetch one Campaign v3 strategy by EID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `strategy_id` | string | Yes | EID of the strategy to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Cross-Device Opt-In

**Slug:** `ADROLL_GET_XDEVICE_OPT_IN`

Retrieve an accessible advertisable's cross-device graph opt-in setting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `advertisable_id` | string | Yes | EID of the advertisable whose cross-device setting to fetch. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Adgroups

**Slug:** `ADROLL_LIST_ADGROUPS`

Return Reporting GraphQL adgroups for one campaign. Omitted collection filters preserve provider defaults; supplied filters constrain active state or included/excluded statuses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `statuses` | array | No | Return only adgroups with one of these provider statuses. |
| `is_active` | boolean | No | Return only adgroups matching this active state. |
| `campaign_id` | string | Yes | EID of the campaign whose adgroups to return. |
| `exclude_statuses` | array | No | Exclude adgroups with these statuses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Ads

**Slug:** `ADROLL_LIST_ADS`

Retrieve one numbered page of ads for an advertisable, or set all='true' to request all matching ads. Omitted pagination inputs send page 1 with 10 records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `all` | string | No | Set to the string 'true' to return all ads. This can be slower than requesting numbered pages. |
| `page` | integer | No | Page number; Composio sends 1 when omitted. |
| `sort` | string | No | Fields and directions to sort by, such as 'eid', 'name desc', or 'name desc, eid'. |
| `page_size` | integer | No | Records per page; Composio sends 10 when omitted. |
| `advertisable` | string | Yes | EID of the advertisable whose ads to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Advertisables

**Slug:** `ADROLL_LIST_ADVERTISABLES`

Fetch one numbered page of advertisables associated with an organization; omitted pagination inputs send page 1 with 10 records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | One-based page number; Composio sends 1 when omitted. |
| `per_page` | integer | No | Number of advertisables to return; Composio sends 10 when omitted. |
| `organization_id` | string | No | Organization EID; omit to use the connected user's organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Assets

**Slug:** `ADROLL_LIST_ASSETS`

Retrieve one numbered page of assets belonging to an advertisable; omitted pagination inputs send page 1 with 10 records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number; Composio sends 1 when omitted. |
| `sort` | string | No | Fields and directions to sort by, such as 'eid', 'name desc', or 'name desc, eid'. |
| `page_size` | integer | No | Records per page; Composio sends 10 when omitted. |
| `advertisable` | string | Yes | EID of the advertisable whose assets to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaigns

**Slug:** `ADROLL_LIST_CAMPAIGNS`

Return Reporting GraphQL campaigns for one advertisable. Omitted collection filters preserve provider defaults; supplied filters support state, classification, channel, source, funnel, objective, and tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `types` | array | No | Return campaigns with these types. |
| `sources` | array | No | Return campaigns from these sources. |
| `channels` | array | No | Return campaigns on these channels. |
| `statuses` | array | No | Return only campaigns with one of these provider statuses. |
| `abm_types` | array | No | Return campaigns with these ABM types. |
| `is_active` | boolean | No | Return only campaigns matching this active state. |
| `use_cases` | array | No | Return campaigns with these use cases. |
| `objectives` | array | No | Return campaigns with these objectives. |
| `tag_prefixes` | array | No | Return campaigns with these tag prefixes. |
| `exclude_types` | array | No | Exclude campaigns with these types. |
| `funnel_stages` | array | No | Return campaigns in these funnel stages. |
| `advertisable_id` | string | Yes | EID of the advertisable whose campaigns to return. |
| `exclude_sources` | array | No | Exclude campaigns from these sources. |
| `targeting_types` | array | No | Return campaigns with these targeting types. |
| `exclude_channels` | array | No | Exclude campaigns on these channels. |
| `exclude_statuses` | array | No | Exclude campaigns with these statuses. |
| `exclude_abm_types` | array | No | Exclude campaigns with these ABM types. |
| `exclude_use_cases` | array | No | Exclude campaigns with these use cases. |
| `exclude_funnel_stages` | array | No | Exclude campaigns in these funnel stages. |
| `exclude_targeting_types` | array | No | Exclude campaigns with these targeting types. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Segments

**Slug:** `ADROLL_LIST_SEGMENTS`

Return audience segments for an advertiser, optionally filtered by segment type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `omit_fields` | string | No | Comma-delimited response fields to omit. Omit this parameter to let AdRoll return its default field set. |
| `segment_type` | string ("crm" | "custom" | "impression" | "user_events" | "user_attributes") | No | Optional documented filter: crm, custom, impression, user_events, or user_attributes. |
| `advertiser_id` | string | Yes | Advertiser or advertisable EID whose segments to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Strategies

**Slug:** `ADROLL_LIST_STRATEGIES`

Return strategies for an advertisable. Cursor, paginate, and include_drafts are omitted unless supplied; the response has no pagination metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Provider cursor to send unchanged. The observed response exposes no continuation cursor. |
| `paginate` | boolean | No | Provider pagination switch; omitted when unset. No synthetic continuation is generated. |
| `include_drafts` | boolean | No | Whether to include draft strategies; omitted by Composio when unset. |
| `advertisable_id` | string | Yes | Advertisable EID whose strategies to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Reporting Adgroups

**Slug:** `ADROLL_REPORTING_ADGROUPS`

Query adgroups by campaign, advertisable, one EID, or many EIDs with nested relations and optional date/currency metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eid` | string | No | Single entity EID for by_eid mode. |
| `eids` | array | No | Entity EIDs for by_eids mode. |
| `currency` | string | No | ISO 4217 metrics currency. |
| `end_date` | string | No | Exclusive metrics end date. |
| `statuses` | array | No | Optional included statuses for parent lists; null preserves the provider collection default. |
| `is_active` | boolean | No | Optional active-state filter for parent lists; null preserves the provider collection default. |
| `past_days` | integer | No | Metrics over the previous N UTC days. |
| `parent_eid` | string | No | Parent EID for a parent-list mode. |
| `start_date` | string | No | Inclusive metrics start date. |
| `lookup_mode` | string ("by_campaign" | "by_advertisable" | "by_eid" | "by_eids") | Yes | List adgroups by parent or look up one or many adgroup EIDs. |
| `include_metrics` | boolean | No | Include summary and daily performance metrics. |
| `exclude_statuses` | array | No | Exclude these adgroup statuses. |
| `include_inactive_relations` | boolean | No | Include inactive nested audiences; Composio sends false when omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Reporting Ads

**Slug:** `ADROLL_REPORTING_ADS`

Query ads by adgroup, advertisable, or Reporting EIDs (`adroll_ad_eid` from the Ad API), with optional date/currency metrics; parent lookup preserves adgroup relationship state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eid` | string | No | Reporting ad EID returned as adroll_ad_eid by the Ad API; required for by_eid mode. |
| `eids` | array | No | Reporting ad EIDs returned as adroll_ad_eid by the Ad API; required for by_eids mode. |
| `types` | array | No | Include these ad types in parent-list modes. |
| `width` | integer | No | Filter by creative width. |
| `height` | integer | No | Filter by creative height. |
| `currency` | string | No | ISO 4217 metrics currency. |
| `end_date` | string | No | Exclusive metrics end date. |
| `statuses` | array | No | Optional included statuses for parent lists; null preserves the provider collection default. |
| `is_active` | boolean | No | Optional active-state filter for parent lists; null preserves the provider collection default. |
| `past_days` | integer | No | Metrics over the previous N UTC days. |
| `parent_eid` | string | No | Parent EID for a parent-list mode. |
| `start_date` | string | No | Inclusive metrics start date. |
| `lookup_mode` | string ("by_adgroup" | "by_advertisable" | "by_eid" | "by_eids") | Yes | List ads by parent or look up one or many ad EIDs. |
| `include_metrics` | boolean | No | Include summary and daily performance metrics. |
| `created_date_before` | string | No | Maximum creation timestamp, inclusive. |
| `updated_date_before` | string | No | Maximum update timestamp, inclusive. |
| `created_date_after_or_on` | string | No | Minimum creation timestamp, inclusive. |
| `updated_date_after_or_on` | string | No | Minimum update timestamp, inclusive. |
| `include_inactive_relations` | boolean | No | Include inactive nested audiences; Composio sends false when omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Reporting Advertisables

**Slug:** `ADROLL_REPORTING_ADVERTISABLES`

Query advertisables by user, organization, one EID, or many EIDs with nested relations and optional date/currency metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eid` | string | No | Single entity EID for by_eid mode. |
| `eids` | array | No | Entity EIDs for by_eids mode. |
| `currency` | string | No | ISO 4217 metrics currency. |
| `end_date` | string | No | Exclusive metrics end date. |
| `statuses` | array | No | Optional included statuses for parent lists; null preserves the provider collection default. |
| `is_active` | boolean | No | Optional active-state filter for parent lists; null preserves the provider collection default. |
| `past_days` | integer | No | Metrics over the previous N UTC days. |
| `parent_eid` | string | No | Parent EID for a parent-list mode. |
| `start_date` | string | No | Inclusive metrics start date. |
| `lookup_mode` | string ("for_user" | "by_organization" | "by_eid" | "by_eids") | No | List the current user's advertisables, list by organization, or look up EIDs. |
| `include_metrics` | boolean | No | Include summary and daily performance metrics. |
| `include_inactive_relations` | boolean | No | Include inactive nested audiences; Composio sends false when omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Reporting Campaigns

**Slug:** `ADROLL_REPORTING_CAMPAIGNS`

Query campaigns by advertisable, organization, one EID, or many EIDs with nested relations and optional date/currency metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eid` | string | No | Single entity EID for by_eid mode. |
| `eids` | array | No | Entity EIDs for by_eids mode. |
| `types` | array | No | Include these campaign types. |
| `sources` | array | No | Include these campaign sources. |
| `channels` | array | No | Include these campaign channels. |
| `currency` | string | No | ISO 4217 metrics currency. |
| `end_date` | string | No | Exclusive metrics end date. |
| `statuses` | array | No | Optional included statuses for parent lists; null preserves the provider collection default. |
| `abm_types` | array | No | Include these ABM types. |
| `is_active` | boolean | No | Optional active-state filter for parent lists; null preserves the provider collection default. |
| `past_days` | integer | No | Metrics over the previous N UTC days. |
| `use_cases` | array | No | Include these campaign use cases. |
| `objectives` | array | No | Include these objectives; supported only by by_advertisable. |
| `parent_eid` | string | No | Parent EID for a parent-list mode. |
| `start_date` | string | No | Inclusive metrics start date. |
| `lookup_mode` | string ("by_advertisable" | "by_organization" | "by_eid" | "by_eids") | Yes | List campaigns by parent or look up one or many campaign EIDs. |
| `tag_prefixes` | array | No | Include campaigns with these tag prefixes. |
| `exclude_types` | array | No | Exclude these campaign types. |
| `funnel_stages` | array | No | Include these funnel stages; supported only by by_advertisable. |
| `exclude_sources` | array | No | Exclude these campaign sources. |
| `include_metrics` | boolean | No | Include summary and daily performance metrics. |
| `targeting_types` | array | No | Include these targeting types. |
| `exclude_channels` | array | No | Exclude these campaign channels. |
| `exclude_statuses` | array | No | Exclude these campaign statuses. |
| `exclude_abm_types` | array | No | Exclude these ABM types. |
| `exclude_use_cases` | array | No | Exclude these campaign use cases. |
| `exclude_funnel_stages` | array | No | Exclude these funnel stages; supported only by by_advertisable. |
| `exclude_targeting_types` | array | No | Exclude these targeting types. |
| `include_inactive_relations` | boolean | No | Include inactive nested audiences; Composio sends false when omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Reporting Organizations

**Slug:** `ADROLL_REPORTING_ORGANIZATIONS`

Query the current AdRoll organization or organizations by one or many EIDs, including nested advertisables.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eid` | string | No | Single entity EID for by_eid mode. |
| `eids` | array | No | Entity EIDs for by_eids mode. |
| `currency` | string | No | ISO 4217 metrics currency. |
| `end_date` | string | No | Exclusive metrics end date. |
| `statuses` | array | No | Optional included statuses for parent lists; null preserves the provider collection default. |
| `is_active` | boolean | No | Optional active-state filter for parent lists; null preserves the provider collection default. |
| `past_days` | integer | No | Metrics over the previous N UTC days. |
| `parent_eid` | string | No | Parent EID for a parent-list mode. |
| `start_date` | string | No | Inclusive metrics start date. |
| `lookup_mode` | string ("current" | "by_eid" | "by_eids") | No | Lookup the current organization or organizations by EID. |
| `include_metrics` | boolean | No | Include summary and daily performance metrics. |
| `include_inactive_relations` | boolean | No | Include inactive nested audiences; Composio sends false when omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Reporting GraphQL Query

**Slug:** `ADROLL_REPORTING_QUERY`

Execute one AdRoll Reporting GraphQL document and preserve complete or partial provider data, errors, request ID, and version.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | GraphQL query document to execute. |
| `variables` | object | No | Variables referenced by the query document. |
| `operation_name` | string | No | Operation name when the document contains multiple operations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Reporting Segments

**Slug:** `ADROLL_REPORTING_SEGMENTS`

Query direct segment metadata or parent-scoped campaign/adgroup audiences with relationship state and optional date-scoped audience-size metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eid` | string | No | Single entity EID for by_eid mode. |
| `eids` | array | No | Entity EIDs for by_eids mode. |
| `currency` | string | No | ISO 4217 metrics currency. |
| `end_date` | string | No | Exclusive metrics end date. |
| `statuses` | array | No | Optional included statuses for parent lists; null preserves the provider collection default. |
| `is_active` | boolean | No | Optional active-state filter for parent lists; null preserves the provider collection default. |
| `past_days` | integer | No | Metrics over the previous N UTC days. |
| `parent_eid` | string | No | Parent EID for a parent-list mode. |
| `start_date` | string | No | Inclusive metrics start date. |
| `lookup_mode` | string ("by_advertisable" | "by_campaign" | "by_adgroup" | "by_eid" | "by_eids") | Yes | Query direct segment metadata or parent-scoped campaign/adgroup audiences. Use parent modes for relationship state and audience-size metrics. |
| `is_conversion` | boolean | No | Return only conversion or non-conversion segments in by_advertisable mode. |
| `include_metrics` | boolean | No | Include summary and daily performance metrics. |
| `include_inactive_relations` | boolean | No | Include inactive nested audiences; Composio sends false when omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Performance Report

**Slug:** `ADROLL_RUN_PERFORMANCE_REPORT`

Return current AdRoll GraphQL delivery metrics for advertisables, campaigns, adgroups, or ads, optionally with attribution metrics, as an aggregate summary, aggregate daily rows, or per-entity summaries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `level` | string ("advertisable" | "campaign" | "adgroup" | "ad") | Yes | Entity level at which to report metrics. |
| `ad_ids` | array | No | Ad EIDs; required only for ad reports. |
| `currency` | string | No | ISO 4217 currency for monetary metrics. |
| `end_date` | string | No | Exclusive report end date. |
| `past_days` | integer | No | Report over the previous N UTC days. |
| `start_date` | string | No | Inclusive report start date. |
| `adgroup_ids` | array | No | Adgroup EIDs; required only for adgroup reports. |
| `data_format` | string ("summary" | "date" | "entity") | No | Aggregate summary, aggregate daily rows, or one summary row per entity. |
| `campaign_ids` | array | No | Campaign EIDs; required only for campaign reports. |
| `advertisable_ids` | array | No | Advertisable EIDs; required only for advertisable reports. |
| `include_attributions` | boolean | No | Include conversion and attribution metrics in addition to delivery metrics. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Geotargets

**Slug:** `ADROLL_SEARCH_GEOTARGETS`

Search AdRoll geotargets by a location-name prefix and optional types. Use count and page to iterate through results until an empty items list is returned.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to request when matches exceed count. Increment page until AdRoll returns an empty results list. |
| `count` | integer | No | Maximum number of geotargets to return on each results page. Use with page to iterate until AdRoll returns an empty results list. |
| `geo_types` | array | No | Geotarget types to include. AdRoll documents this query as a string enum while also requiring comma-delimited values; the list is sent as CSV. |
| `starts_with` | string | No | Beginning of the geotarget location name to match. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Campaign Status

**Slug:** `ADROLL_SET_CAMPAIGN_STATUS`

Pause or activate one campaign through the Campaign v3 edit operation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("paused" | "active") | Yes | Desired delivery state: paused stops delivery and active maps to Campaign v3 live. |
| `campaign_id` | string | Yes | EID of the campaign whose delivery state to change. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Adgroup

**Slug:** `ADROLL_UPDATE_ADGROUP`

Edit one web-retargeting or web-prospecting Campaign v3 adgroup.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `adgroup` | string | Yes | Exact Campaign v3 web-retargeting or web-prospecting adgroup edit body. |
| `adgroup_id` | string | Yes | EID of the adgroup to edit. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Campaign

**Slug:** `ADROLL_UPDATE_CAMPAIGN`

Edit one Campaign v3 campaign. Retargeting nested adgroups are inferred as create-or-edit by eid; prospecting nested adgroups must include eid.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign` | string | Yes | Exact Campaign v3 web-retargeting or web-prospecting campaign edit body. |
| `campaign_id` | string | Yes | EID of the campaign to edit. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Consent Banner

**Slug:** `ADROLL_UPDATE_CONSENT_BANNER`

Create or update an advertisable's consent banner configuration. AdRoll permits banner_declined only for advertisables in countries not covered by GDPR.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string ("adroll" | "custom_pending" | "banner_declined") | Yes | New banner state. banner_declined is allowed only for non-GDPR-country advertisables. |
| `advertisable_id` | string | Yes | EID of the advertisable whose consent configuration to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Segment

**Slug:** `ADROLL_UPDATE_SEGMENT`

Update audience-segment information and submit its user-record payload.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Human-readable segment name shown in the AdRoll dashboard. |
| `users` | array | Yes | User records submitted in the segment update payload. |
| `segment_id` | string | Yes | EID of the segment to update. |
| `duration_days` | integer | No | New membership duration in days; omit to leave it unchanged. |
| `conversion_value` | number | No | New conversion value; omit to leave it unchanged. |
| `general_exclusion_type` | string ("customers" | "coworkers" | "competitors") | No | New general-exclusion classification; omit to leave it unchanged. |
| `salesforce_company_list_id` | string | No | New Salesforce company-list ID; omit to leave it unchanged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Strategy

**Slug:** `ADROLL_UPDATE_STRATEGY`

Edit a Campaign v3 strategy using a caller-provided complete campaign set. Nested campaigns with eid are edited and those without eid are created. Any existing campaign omitted from campaigns is deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `strategy` | object | Yes | Exact Campaign v3 strategy edit body with the complete current campaign set. Campaigns omitted from that set are deleted, so campaigns is required on every call and must include every existing campaign to retain. |
| `strategy_id` | string | Yes | EID of the strategy to edit. |
| `confirm_complete_web_campaign_set` | boolean | Yes | Confirm that the strategy contains only web-retargeting or web-prospecting campaigns and that strategy.campaigns is the complete set to retain. Mixed-channel strategies are not supported because the provider does not document social-channel campaign edit inputs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Cross-Device Opt-In

**Slug:** `ADROLL_UPDATE_XDEVICE_OPT_IN`

Update an accessible advertisable's cross-device graph opt-in setting; provider feature access is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `value` | boolean | Yes | Whether the advertisable should opt into the cross-device graph. |
| `advertisable_id` | string | Yes | EID of the advertisable whose cross-device setting to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |