AdRoll integration
AdRoll is a retargeting and display advertising platform. With this integration an agent can list the advertisables (advertiser accounts) of an organization and read their pixel, rules and pixel segments; create, read and edit strategies (budget containers), campaigns and adgroups with their targeting, budgets and status; list, read and create ads and their assets; search geotargets to attach to adgroups; and list, create, read, update and delete audience segments, including appending CRM email lists. Not included: advertisable creation and editing, marketplace mappings, consent banner and cross-device settings, rule creation (a CSV upload), the GraphQL reporting API and the older CRUD API routes. Authentication is OAuth 2.0 (authorization code grant, scope all) against an application registered on the AdRoll developer site; access tokens last 24 hours and are refreshed automatically, and a refresh token is replaced on every use. The default quota is 100 API requests per service per day. Creating or editing a live strategy, campaign or adgroup can spend advertising budget.
Say what should happen.
The workflow builds itself.
What you can do with AdRoll
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Segment, 5 operations
create_segmentCreate segmentPOSTCreates an audience segment (for example a CRM list) for an advertiser, with its first user records in data.delete_segmentDelete segmentDELETEDeletes an audience segment. This cannot be undone.get_segmentGet segmentGETReturns one audience segment: its name, type, duration and the number of emails or ids it holds.list_segmentsList segmentsGETLists the audience segments of an advertiser, optionally filtered by type (crm, custom, impression, user_events, user_attributes).update_segmentUpdate segmentPOSTUpdates a segment's name, duration or conversion value and appends the user records given in data.
Strategy, 4 operations
create_strategyCreate strategyPOSTCreates a strategy (the budget container of campaigns) for an advertisable. Set is_draft to true to create it as a draft that does not run.get_strategyGet strategyGETReturns one strategy by EID: name, status, budget and spend, dates, currency and its campaigns with their adgroups.list_strategiesList strategiesGETLists the strategies of an advertisable, each with its budget, dates, status and campaigns. Set include_drafts to true to include drafts.update_strategyUpdate strategyPUTEdits a strategy: name, status, budget, dates, budget balancing or its campaigns. Leave out any field to keep its current value.
Ad, 3 operations
create_adCreate adPOSTCreates an ad for an advertisable with its assets; assets sent without an eid are created with the ad.get_adGet adGETReturns one ad by EID: its name, type, subtype, size, status and assets.list_adsList adsGETLists the ads of an advertisable, a page at a time (page, page_size), each with its type, size, status and assets.
Adgroup, 3 operations
create_adgroupCreate adgroupPOSTCreates an adgroup inside a campaign, with its segments, ads, geotargets, keywords and flights. Leave status out to create it without making it live.get_adgroupGet adgroupGETReturns one adgroup by EID: its name, status, flights, targeted segments, ads, geotargets, keywords and device targets.update_adgroupUpdate adgroupPUTEdits an adgroup: name, status, segments, ads, geotargets, keywords, flights or device targets. Leave out any field to keep its current value.
Asset, 3 operations
create_assetCreate assetPOSTCreates an asset (a text, image or video) for an advertisable; an image is sent base64-encoded in file.get_assetGet assetGETReturns one asset by EID: its name, type, subtype and content.list_assetsList assetsGETLists the assets (texts, images, videos) of an advertisable, a page at a time (page, page_size).
Campaign, 3 operations
create_campaignCreate campaignPOSTCreates a campaign inside a strategy, optionally with its adgroups. A campaign can spend budget once its strategy and adgroups are live.get_campaignGet campaignGETReturns one campaign by EID: name, status, KPI, dayparting, frequency cap, daily budget and its adgroups.update_campaignUpdate campaignPUTEdits a campaign: name, status, KPI, dayparting, frequency cap, daily budget, adgroups or contextual categories. Leave out any field to keep its current value.
Advertisable, 2 operations
get_advertisableGet advertisableGETReturns one advertisable by EID: name, URL, country, currency, logo and organization.list_advertisablesList advertisablesGETLists the advertisables (advertiser accounts) of your organization, a page at a time. Use results.eid as the advertisable EID other tools take.
Pixel, 2 operations
get_advertisable_pixelGet advertisable pixelGETReturns the active pixel of an advertisable: its EID, status, the code snippet to place on the site and the dates it was placed or dropped.get_pixelGet pixelGETReturns one pixel by EID: its status, the HTML/JavaScript snippet to place on the site, and the dates it was last placed or dropped.
Geotarget, 1 operation
search_geotargetsSearch geotargetsGETSearches geotargets (countries, metros, regions, cities, postal codes) by the beginning of their name. Use a result's eid in an adgroup's geotargets.
Pixel segment, 1 operation
list_pixel_segmentsList pixel segmentsGETLists the segments associated with a pixel, each with its rule, pattern, type, duration and status.
Rule, 1 operation
get_ruleGet ruleGETReturns one rule by EID: its name, URL pattern, type, source, priority order and the segments attached to it.
Rule segment, 1 operation
list_rule_segmentsList rule segmentsGETLists the segments attached to one rule.
Use AdRoll from Claude Code, Cursor or Codex
Connect AdRoll in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its AdRoll operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect AdRoll
- Create your workspace
Sign up free. Nothing to install.
- Connect AdRoll once
Add your AdRoll connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
AdRoll integration FAQ
What can you do with the AdRoll integration?
LiveContext exposes 29 operations on AdRoll, covering segment, strategy, ad and adgroup.
