AdRoll for AI agents
Agents read AdRoll at once. Changes and sends are held for a person's approval by default.
About AdRoll
AdRoll is a digital marketing platform for managing advertising campaigns, audiences, account-based marketing, and performance reporting.
What an agent can do in AdRoll
Every AdRoll action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in AdRoll without asking first. 32 actions.
- Get AdRetrieve an ad by its Ad API resource eid, not its Reporting adroll_ad_eid.
- Get AdgroupFetch one Campaign v3 adgroup by EID.
- Get Adgroup GeotargetsFetch a Campaign v3 adgroup and return only its geotarget configuration.
- Get AdvertisableFetch an advertisable by EID. AdRoll returns matching records as an array.
- Get Advertisable PixelFetch the active pixel for an accessible advertisable.
- Get AssetRetrieve an asset by its EID.
- Get CampaignFetch one Campaign v3 campaign by advertisable and campaign EID.
- Get Consent BannerFetch an advertisable's consent banner state. banner_declined is available only to advertisables in countries not covered by GDPR.
- Get Current OrganizationReturn the connected account's current organization from Reporting GraphQL, including nested advertisables.
- Get Marketplace MappingsRetrieve marketplace mappings for a parent marketplace advertisable and child merchant advertisable. Both must be accessible and marketplace-enabled by AdRoll.
- Get PixelFetch a pixel by EID.
- Get Pixel SegmentsFetch 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.
Show all 32
- Get RuleFetch a rule by EID, including its generated segments when returned.
- Get Rule SegmentsFetch the segments associated with a specific rule.
- Get SegmentReturn one audience segment, optionally including general-exclusion attributes or an inactive segment.
- Get StrategyFetch one Campaign v3 strategy by EID.
- Get Cross-Device Opt-InRetrieve an accessible advertisable's cross-device graph opt-in setting.
- List AdgroupsReturn Reporting GraphQL adgroups for one campaign. Omitted collection filters preserve provider defaults; supplied filters constrain active state or included/excluded statuses.
- List AdsRetrieve 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.
- List AdvertisablesFetch one numbered page of advertisables associated with an organization; omitted pagination inputs send page 1 with 10 records.
- List AssetsRetrieve one numbered page of assets belonging to an advertisable; omitted pagination inputs send page 1 with 10 records.
- List CampaignsReturn Reporting GraphQL campaigns for one advertisable. Omitted collection filters preserve provider defaults; supplied filters support state, classification, channel, source, funnel, objective, and
- List SegmentsReturn audience segments for an advertiser, optionally filtered by segment type.
- List StrategiesReturn strategies for an advertisable. Cursor, paginate, and include_drafts are omitted unless supplied; the response has no pagination metadata.
- Query Reporting AdgroupsQuery adgroups by campaign, advertisable, one EID, or many EIDs with nested relations and optional date/currency metrics.
- Query Reporting AdsQuery 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.
- Query Reporting AdvertisablesQuery advertisables by user, organization, one EID, or many EIDs with nested relations and optional date/currency metrics.
- Query Reporting CampaignsQuery campaigns by advertisable, organization, one EID, or many EIDs with nested relations and optional date/currency metrics.
- Query Reporting OrganizationsQuery the current AdRoll organization or organizations by one or many EIDs, including nested advertisables.
- Run Reporting GraphQL QueryExecute one AdRoll Reporting GraphQL document and preserve complete or partial provider data, errors, request ID, and version.
- Query Reporting SegmentsQuery direct segment metadata or parent-scoped campaign/adgroup audiences with relationship state and optional date-scoped audience-size metrics.
- Search GeotargetsSearch 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.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 18 actions.
- Create AdCreate an ad for an advertisable, optionally creating nested assets that do not have EIDs in the same operation.
- Create AdgroupCreate a web-retargeting adgroup under a Campaign v3 campaign.
- Create AdvertisableCreate an advertisable in an organization owned by the connected account.
- Create AssetCreate an asset. File content is passed exactly as a base64 string in the JSON request body.
- Create CampaignCreate a web-retargeting campaign under a Campaign v3 strategy.
- Create Marketplace MappingCreate a marketplace-to-merchant mapping. Both advertisables must be accessible and marketplace-enabled by AdRoll.
- Create RuleCreate 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
- Create SegmentCreate one audience segment for an advertiser and seed it with user identifiers.
- Create StrategyCreate a Campaign v3 strategy under an advertisable.
- Delete SegmentDelete one existing audience segment.
- Edit AdvertisableEdit the name, URL, or country code of an accessible advertisable.
- Run Performance ReportReturn 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 summari
Show all 18
- Set Campaign StatusPause or activate one campaign through the Campaign v3 edit operation.
- Update AdgroupEdit one web-retargeting or web-prospecting Campaign v3 adgroup.
- Update CampaignEdit one Campaign v3 campaign. Retargeting nested adgroups are inferred as create-or-edit by eid; prospecting nested adgroups must include eid.
- Update Consent BannerCreate or update an advertisable's consent banner configuration. AdRoll permits banner_declined only for advertisables in countries not covered by GDPR.
- Update SegmentUpdate audience-segment information and submit its user-record payload.
- Update Cross-Device Opt-InUpdate an accessible advertisable's cross-device graph opt-in setting; provider feature access is required.
Changes wait in Needs you
Changes and sends in AdRoll are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
AdRoll questions
Can an agent change data in AdRoll on its own?
Not by default. Changes and sends in AdRoll are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in AdRoll?
This connector lists 32 read actions. Reads run at once, without waiting for approval.
How does AdRoll connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.