# AdCrunch Docs

> Documentation for AdCrunch — connect your ad platforms to AI agents and query campaigns in natural language.

## Docs

- [Welcome to AdCrunch](https://docs.adcrunch.dev/): The documentation of AdCrunch. Connect Meta, TikTok and Google Ads to Claude, ChatGPT, the console, or the REST API. Read your campaigns, and change what runs.

## Start here

- [Quickstart](https://docs.adcrunch.dev/quickstart): Connect Meta, TikTok and Google Ads once. Read live campaign performance and change what is running — from Claude, ChatGPT, the console, or the REST API.
- [Concepts](https://docs.adcrunch.dev/concepts): Every noun AdCrunch uses, defined once — organization, advertiser, entity, insight, mutation, and the things you write down for an agent to read.

## Connect a provider

- [What each provider supports](https://docs.adcrunch.dev/connect/providers): One table for every ad platform AdCrunch connects to — what it reads, what it can change, what you pass as the API value, and where each capability stops.
- [Connect Meta](https://docs.adcrunch.dev/connect/meta): Authorize AdCrunch on a Meta ad account and pick which advertisers to sync.

## Work in the console

- [The Adgent](https://docs.adcrunch.dev/console/adgent): The chat agent of the console. Open it on its own page or beside the page that you read. Add images and PDF files to a message.
- [Advertisers](https://docs.adcrunch.dev/console/advertisers): An advertiser is one ad account on one provider. Stable ID prefix acc_.
- [Performance](https://docs.adcrunch.dev/console/insights): Read spend, clicks and conversions across every connected ad account on one page, grouped by the level you choose and converted into one currency.
- [Skills](https://docs.adcrunch.dev/console/skills): Ad-ops playbooks your connected AI agents can run via the AdCrunch MCP server. Write them in the console, or import them from the Skill Catalog.
- [Brands](https://docs.adcrunch.dev/console/brands): The context your agents read before they write anything — one body of markdown — plus the website, files, logo and ad accounts that go with it.
- [Campaign Plans](https://docs.adcrunch.dev/console/campaign-plans): Find, favorite, duplicate and delete your campaign plans in the console, read their delivery, and open the page of each line item.

## Account

- [API keys](https://docs.adcrunch.dev/account/api-keys): Create a key to call the AdCrunch REST API from your own code, understand whose permissions it uses and when it stops working, and revoke it.

## Connect to AI agents

- [Connect to AI agents](https://docs.adcrunch.dev/mcp): Wire AdCrunch into Claude and ChatGPT via the MCP server. A guide for each job, one page for each tool, and the boundary an agent works inside.

### Start here

- [What is MCP](https://docs.adcrunch.dev/mcp/overview): What the AdCrunch MCP server lets an AI agent do with your ad accounts, and the six jobs it does.
- [What to expect](https://docs.adcrunch.dev/mcp/what-to-expect): The rules that each AdCrunch tool follows — which organization your client acts for, how fresh the data is, how money is stated, and what happens when you ask for a change.
- [Prompts](https://docs.adcrunch.dev/mcp/prompts): Run a Skill, or insert the context of a brand, from the slash menu of your AI client and of the Adgent.

### Set up your AI client

- [Claude](https://docs.adcrunch.dev/mcp/setup/claude-desktop): Add AdCrunch to Claude as a custom connector, on claude.ai, Claude Desktop, and the mobile apps.
- [Claude Code](https://docs.adcrunch.dev/mcp/setup/claude-code): Install the AdCrunch MCP server in Claude Code and authorize your organization.
- [ChatGPT](https://docs.adcrunch.dev/mcp/setup/chatgpt): Add AdCrunch to ChatGPT as an app in developer mode.
- [Another client](https://docs.adcrunch.dev/mcp/setup/other-clients): Connect a client that you build, or a client with no page here — the endpoint, the transport, the protocol versions, OAuth discovery, and the discovery documents.

### Auth and errors

- [Auth & scopes](https://docs.adcrunch.dev/mcp/auth): How OAuth works for the MCP server, what each scope grants, what an agent can and cannot change, and how access is revoked.
- [Errors](https://docs.adcrunch.dev/mcp/errors): The one shape of a failed tool call — the code in structuredContent and the sentence in the text — the codes that each tool can send, and what to do next.

### Tools

- [request_capability](https://docs.adcrunch.dev/mcp/tools/request-capability): Tell AdCrunch about a task that no tool can do yet.
- [organization_member_list](https://docs.adcrunch.dev/mcp/tools/organization-member-list): List the members of your organization with their ids, names and emails.

#### Read your accounts

- [Read your accounts](https://docs.adcrunch.dev/mcp/tools/read-your-accounts): Ask an AI agent which ad accounts you have, what runs in them, and what they spend and return. The agent reads what AdCrunch stores, or it asks the provider now, and it changes nothing.
- [list_advertisers](https://docs.adcrunch.dev/mcp/tools/list-advertisers): List the advertisers (ad accounts) in your organization, optionally filtered by provider.
- [list_campaigns](https://docs.adcrunch.dev/mcp/tools/list-campaigns): List the campaigns of your ad accounts at Meta, TikTok and Google Ads, as AdCrunch stores them.
- [get_campaign](https://docs.adcrunch.dev/mcp/tools/get-campaign): Get all the stored fields of one campaign at Meta, TikTok or Google Ads.
- [list_ad_groups](https://docs.adcrunch.dev/mcp/tools/list-ad-groups): List the ad groups of your ad accounts — Meta ad sets, TikTok ad groups and Google Ads ad groups — as AdCrunch stores them.
- [get_ad_group](https://docs.adcrunch.dev/mcp/tools/get-ad-group): Get all the stored fields of one ad group — a Meta ad set, a TikTok ad group or a Google Ads ad group.
- [list_ads](https://docs.adcrunch.dev/mcp/tools/list-ads): List the ads of your ad accounts at Meta, TikTok and Google Ads, as AdCrunch stores them.
- [get_ad](https://docs.adcrunch.dev/mcp/tools/get-ad): Get all the stored fields of one ad at Meta, TikTok or Google Ads.
- [list_creatives](https://docs.adcrunch.dev/mcp/tools/list-creatives): List the creatives of your Meta ad accounts, as AdCrunch stores them.
- [get_creative](https://docs.adcrunch.dev/mcp/tools/get-creative): Get all the stored fields of one Meta creative — its headline, its text, its image or video, its call to action and its link.
- [list_asset_groups](https://docs.adcrunch.dev/mcp/tools/list-asset-groups): List the asset groups of your Google Ads Performance Max campaigns, as AdCrunch stores them.
- [get_asset_group](https://docs.adcrunch.dev/mcp/tools/get-asset-group): Get all the stored fields of one Google Ads asset group.
- [query_insights](https://docs.adcrunch.dev/mcp/tools/query-insights): Aggregate spend / impressions / clicks / conversions over a date range, by entity.

##### meta_list_*

- [meta_list_campaigns](https://docs.adcrunch.dev/mcp/tools/meta-list-campaigns): Read the campaigns of one Meta ad account from Meta now, with the status and the budget of each.
- [meta_list_adsets](https://docs.adcrunch.dev/mcp/tools/meta-list-adsets): Read the ad sets of one Meta ad account from Meta now, with the status and the budget of each.
- [meta_list_ads](https://docs.adcrunch.dev/mcp/tools/meta-list-ads): Read the ads of one Meta ad account from Meta now, with the status of each.
- [meta_list_creatives](https://docs.adcrunch.dev/mcp/tools/meta-list-creatives): Read the ad creatives of one Meta ad account from Meta now.

##### tiktok_list_*

- [tiktok_list_campaigns](https://docs.adcrunch.dev/mcp/tools/tiktok-list-campaigns): Read the campaigns of one TikTok ad account from TikTok now, with the status and the budget of each.
- [tiktok_list_adgroups](https://docs.adcrunch.dev/mcp/tools/tiktok-list-adgroups): Read the ad groups of one TikTok ad account from TikTok now, with the status and the budget of each.
- [tiktok_list_ads](https://docs.adcrunch.dev/mcp/tools/tiktok-list-ads): Read the ads of one TikTok ad account from TikTok now, with the status of each.

##### gads_list_*

- [gads_list_campaigns](https://docs.adcrunch.dev/mcp/tools/gads-list-campaigns): Read the campaigns of one Google Ads account from Google Ads now, with the status and the budget of each.
- [gads_list_ad_groups](https://docs.adcrunch.dev/mcp/tools/gads-list-ad-groups): Read the ad groups of one Google Ads account from Google Ads now, with the status of each.
- [gads_list_ad_group_ads](https://docs.adcrunch.dev/mcp/tools/gads-list-ad-group-ads): Read the ads of one Google Ads account from Google Ads now, with the status of each.
- [gads_list_asset_groups](https://docs.adcrunch.dev/mcp/tools/gads-list-asset-groups): Read the asset groups of one Google Ads account from Google Ads now, with the status of each.

##### openai_list_*

- [openai_list_campaigns](https://docs.adcrunch.dev/mcp/tools/openai-list-campaigns): Read the campaigns of one OpenAI ad account from OpenAI now, with the status and the budget of each.

#### Change what runs on Meta

- [Change what runs on Meta](https://docs.adcrunch.dev/mcp/tools/change-what-runs-on-meta): Build or copy a paused campaign on a Meta advertiser, then start it, stop it, or change its budget, its bid, its schedule or its name, from a conversation. Each change runs in the background, nothing spends until you activate it, and you confirm each change that starts spend in the console.
- [get_mutation_status](https://docs.adcrunch.dev/mcp/tools/get-mutation-status): Find out how a change on Meta ended, after a write tool started it.

##### meta_*

- [meta_list_pages](https://docs.adcrunch.dev/mcp/tools/meta-list-pages): List the Facebook Pages that your Meta connection can advertise from.
- [meta_list_pixels](https://docs.adcrunch.dev/mcp/tools/meta-list-pixels): List the Meta Pixels installed on a Meta advertiser.
- [meta_search_targeting](https://docs.adcrunch.dev/mcp/tools/meta-search-targeting): Search the Meta interests and job titles that an ad set can target.
- [meta_list_pixel_events](https://docs.adcrunch.dev/mcp/tools/meta-list-pixel-events): List the events that a Meta Pixel received in the last 7 days.
- [meta_list_custom_conversions](https://docs.adcrunch.dev/mcp/tools/meta-list-custom-conversions): List the custom conversions of a Meta advertiser.
- [meta_list_custom_audiences](https://docs.adcrunch.dev/mcp/tools/meta-list-custom-audiences): List the Custom Audiences of a Meta advertiser.
- [meta_create_campaign](https://docs.adcrunch.dev/mcp/tools/meta-create-campaign): Create a Meta campaign from a conversation. It always arrives paused.
- [meta_create_adset](https://docs.adcrunch.dev/mcp/tools/meta-create-adset): Create a Meta ad set under a campaign, with its audience and its optimization goal. It always arrives paused.
- [meta_create_creative](https://docs.adcrunch.dev/mcp/tools/meta-create-creative): Build a Meta ad creative from an asset that you uploaded to AdCrunch. Image and video both work.
- [meta_create_ad](https://docs.adcrunch.dev/mcp/tools/meta-create-ad): Create a Meta ad under an ad set, with a creative that already exists. It always arrives paused.
- [meta_create_custom_audience](https://docs.adcrunch.dev/mcp/tools/meta-create-custom-audience): Create a Meta Custom Audience from the visitors of a Pixel, from a list of your customers, or as a lookalike of another audience.
- [meta_get_ad_preview](https://docs.adcrunch.dev/mcp/tools/meta-get-ad-preview): See a Meta ad as Meta renders it in each placement, before it goes live.
- [meta_copy_campaign](https://docs.adcrunch.dev/mcp/tools/meta-copy-campaign): Copy a Meta campaign into the same ad account, with no ad set and no ad. The copy always arrives paused.
- [meta_copy_adset](https://docs.adcrunch.dev/mcp/tools/meta-copy-adset): Copy a Meta ad set into its own campaign or into another campaign of the ad account, with no ad. The copy always arrives paused.
- [meta_update_status](https://docs.adcrunch.dev/mcp/tools/meta-update-status): Pause, resume or archive a Meta campaign, ad set or ad.
- [meta_update_budget](https://docs.adcrunch.dev/mcp/tools/meta-update-budget): Change the daily or lifetime budget of a Meta campaign or ad set, with a safety cap and a level check.
- [meta_update_bidding](https://docs.adcrunch.dev/mcp/tools/meta-update-bidding): Change the bid strategy of a Meta campaign or ad set, and the amount that the strategy takes, at the level where the budget sits.
- [meta_update_schedule](https://docs.adcrunch.dev/mcp/tools/meta-update-schedule): Change the start time or the end time of a Meta ad set, or remove its end, with a check of the end time.
- [meta_update_name](https://docs.adcrunch.dev/mcp/tools/meta-update-name): Rename a Meta campaign, ad set or ad.

#### Plan a campaign

- [Plan a campaign](https://docs.adcrunch.dev/mcp/tools/plan-a-campaign): Ask your agent to write down what you intend to run, approve it in the AdCrunch console, build it on Meta, record what it created, and read what it delivered.

##### campaign_plan_*

- [campaign_plan_list](https://docs.adcrunch.dev/mcp/tools/campaign-plan-list): List the Campaign Plans of your organization, with the money figures that you rank them by.
- [campaign_plan_get](https://docs.adcrunch.dev/mcp/tools/campaign-plan-get): Get one Campaign Plan with its money figures and its number of Line Items.
- [campaign_plan_create](https://docs.adcrunch.dev/mcp/tools/campaign-plan-create): Write down what you intend to run: the channels, the audience, the money and the dates.
- [campaign_plan_update](https://docs.adcrunch.dev/mcp/tools/campaign-plan-update): Edit a Campaign Plan. A real change returns an approved Campaign Plan to draft.
- [campaign_plan_delete](https://docs.adcrunch.dev/mcp/tools/campaign-plan-delete): Delete a Campaign Plan and its Line Items. What they created stays live.
- [campaign_plan_delivery](https://docs.adcrunch.dev/mcp/tools/campaign-plan-delivery): Read what each Line Item of a Campaign Plan delivered: its spend and results, its pacing against its budget, and its target.
- [campaign_plan_comment_list](https://docs.adcrunch.dev/mcp/tools/campaign-plan-comment-list): List the Comments of a Campaign Plan, by thread, newest thread first.
- [campaign_plan_comment_create](https://docs.adcrunch.dev/mcp/tools/campaign-plan-comment-create): Post a Comment on a Campaign Plan, or a reply in one of its threads.
- [campaign_plan_assignee_add](https://docs.adcrunch.dev/mcp/tools/campaign-plan-assignee-add): Make a member of your organization an Assignee of a Campaign Plan.
- [campaign_plan_assignee_remove](https://docs.adcrunch.dev/mcp/tools/campaign-plan-assignee-remove): Remove an Assignee from a Campaign Plan.

##### line_item_*

- [line_item_list](https://docs.adcrunch.dev/mcp/tools/line-item-list): List the Line Items of one Campaign Plan, newest first, with what each Line Item created.
- [line_item_get](https://docs.adcrunch.dev/mcp/tools/line-item-get): Read one Line Item with its readiness: if AdCrunch can build it now, and why not when it cannot.
- [line_item_create](https://docs.adcrunch.dev/mcp/tools/line-item-create): Add a Line Item to a Campaign Plan: one thing that you buy, with the limits of an intent.
- [line_item_update](https://docs.adcrunch.dev/mcp/tools/line-item-update): Edit a Line Item. A real change returns that Line Item to draft, and no other.
- [line_item_delete](https://docs.adcrunch.dev/mcp/tools/line-item-delete): Remove a Line Item from a Campaign Plan. What it created stays live.
- [line_item_record_execution](https://docs.adcrunch.dev/mcp/tools/line-item-record-execution): Record one provider object that a Line Item created, so that the Campaign Plan shows what came from where.

#### Describe a brand

- [Describe a brand](https://docs.adcrunch.dev/mcp/tools/describe-a-brand): Write down who a brand is, how it sounds and who it talks to. Your agent reads it before it writes copy or judges an ad account.
- [read_web_page](https://docs.adcrunch.dev/mcp/tools/read-web-page): Read one public web page, such as the website of a brand, as text.

##### brand_*

- [brand_list](https://docs.adcrunch.dev/mcp/tools/brand-list): List the brands of your organization, so that an agent can pick one before it reads the brand in full.
- [brand_get](https://docs.adcrunch.dev/mcp/tools/brand-get): Read one brand in full: its body, its personas, its files and its ad accounts. An agent reads it before it acts for the brand.
- [brand_resolve](https://docs.adcrunch.dev/mcp/tools/brand-resolve): Find the brands whose context applies to an ad account.
- [brand_create](https://docs.adcrunch.dev/mcp/tools/brand-create): Create a brand in your organization. You can write its body now or later.
- [brand_update](https://docs.adcrunch.dev/mcp/tools/brand-update): Change a brand. The revision that the agent read stops it from overwriting a change that it did not see.
- [brand_attach_advertiser](https://docs.adcrunch.dev/mcp/tools/brand-attach-advertiser): Attach an ad account to a brand, so that an agent that works on the ad account finds the brand.
- [brand_detach_advertiser](https://docs.adcrunch.dev/mcp/tools/brand-detach-advertiser): Remove the link between an ad account and a brand. The brand and its context stay.
- [brand_assignee_add](https://docs.adcrunch.dev/mcp/tools/brand-assignee-add): Make a member of your organization an Assignee of a brand.
- [brand_assignee_remove](https://docs.adcrunch.dev/mcp/tools/brand-assignee-remove): Remove an Assignee from a brand.
- [brand_delete](https://docs.adcrunch.dev/mcp/tools/brand-delete): Delete a brand and all that it holds. The revision that the agent read stops the delete of a brand that changed.

##### persona_*

- [persona_get](https://docs.adcrunch.dev/mcp/tools/persona-get): Read one persona of a brand: who the brand talks to, and the words that this audience uses.
- [persona_create](https://docs.adcrunch.dev/mcp/tools/persona-create): Add a persona to a brand: an audience that the brand talks to.
- [persona_update](https://docs.adcrunch.dev/mcp/tools/persona-update): Change the body, the age range or the slug of a persona. The revision that the agent read stops it from overwriting a change that it did not see.
- [persona_delete](https://docs.adcrunch.dev/mcp/tools/persona-delete): Delete a persona from a brand. The revision that the agent read stops the delete of a persona that changed.

##### document_*

- [document_create_upload](https://docs.adcrunch.dev/mcp/tools/document-create-upload): Reserve a file on a brand, and get a URL for its bytes. This is the first step of an upload.
- [document_finalize](https://docs.adcrunch.dev/mcp/tools/document-finalize): Finish an upload. AdCrunch reads the type and the size from the stored file, not from what the agent declared.
- [document_get](https://docs.adcrunch.dev/mcp/tools/document-get): Read one file of a brand. An image comes back as an image that the agent can look at.
- [document_list](https://docs.adcrunch.dev/mcp/tools/document-list): List the files of a brand, each with its URL.
- [document_delete](https://docs.adcrunch.dev/mcp/tools/document-delete): Delete a file of a brand, and its stored bytes.

#### Bring your own creative

- [Bring your own creative](https://docs.adcrunch.dev/mcp/tools/bring-your-own-creative): Add an image or a video that you own from its URL, and register it into the provider library of one advertiser, so that an ad there can use it. All from your AI client.
- [asset_list](https://docs.adcrunch.dev/mcp/tools/asset-list): List the images and videos that your organization owns as Assets, each with its Registrations.
- [asset_get](https://docs.adcrunch.dev/mcp/tools/asset-get): Fetch one Asset with its Registrations, and the state of each one. The agent polls a running Registration with this tool.
- [asset_create](https://docs.adcrunch.dev/mcp/tools/asset-create): Create an Asset from the public URL of an image or a video. AdCrunch fetches and checks the file in the background.
- [asset_create_upload](https://docs.adcrunch.dev/mcp/tools/asset-create-upload): Create an Asset from bytes that the client holds. The client sends the file to a short-lived upload URL.
- [asset_register](https://docs.adcrunch.dev/mcp/tools/asset-register): Register an Asset into the provider library of one advertiser, so that an ad of that advertiser can use it. The call returns at once, and asset_get gives the state.

#### Reuse a playbook

- [Reuse a playbook](https://docs.adcrunch.dev/mcp/tools/reuse-a-playbook): Save a way of working as a Skill, then let each agent of your organization find it, run it, change it and delete it from your AI client.
- [skill_list](https://docs.adcrunch.dev/mcp/tools/skill-list): List the Skills of your organization by slug, name and description, newest first.
- [skill_get](https://docs.adcrunch.dev/mcp/tools/skill-get): Read one Skill by its slug, with its playbook and its current revision.
- [skill_create](https://docs.adcrunch.dev/mcp/tools/skill-create): Save a way of working as a new Skill of your organization.
- [skill_update](https://docs.adcrunch.dev/mcp/tools/skill-update): Change a Skill, with a revision check that keeps a change that somebody else made.
- [skill_delete](https://docs.adcrunch.dev/mcp/tools/skill-delete): Delete a Skill, with a revision check that keeps a change that somebody else made.

## AdCrunch API

- [AdCrunch API](https://docs.adcrunch.dev/api): Every AdCrunch API, in one document. Each API also publishes its own, at /openapi/<name>.json.

### Start here

- [Introduction](https://docs.adcrunch.dev/api/introduction): What the AdCrunch REST API does, when to use it instead of MCP, and how to make your first request with an API key.
- [Authentication](https://docs.adcrunch.dev/api/authentication): Send an API key as a bearer token, learn which organization and which permissions it carries, and see which permission each AdCrunch API needs.
- [Errors](https://docs.adcrunch.dev/api/errors): The one shape of an AdCrunch failure, the field to branch on, the order of the checks, and the codes that more than one operation sends.
- [Conventions](https://docs.adcrunch.dev/api/conventions): The rules that cross the AdCrunch APIs — ids, provider values, money, time, casing, paths, and pagination — including the places where the APIs do not agree yet.

### Workflows

- [Make a change](https://docs.adcrunch.dev/api/make-a-change): Change what runs on an advertiser with the Mutations API — start a Mutation, poll it until it ends, and read the history of each change.
- [Upload a file](https://docs.adcrunch.dev/api/upload-a-file): Upload an image or a video as an Asset, or a file as a Brand Document. Then register an Asset in the library of an advertiser.
- [Edit without overwriting](https://docs.adcrunch.dev/api/edit-without-overwriting): Change a Skill, a Brand, a Persona, a Campaign Plan, or a Line Item without overwriting an edit that somebody else made after you read it.
- [Assign a member](https://docs.adcrunch.dev/api/assign-a-member): Make a member of your organization the Assignee of a Brand or a Campaign Plan, and list the records assigned to a member.

### Insights

- [List insights](https://docs.adcrunch.dev/api/insights/list-insights): Available on: Meta TikTok Google Ads OpenAI. Reference for the GET /observe/insights endpoint in the AdCrunch API.

### Campaigns

- [List an advertiser’s campaigns](https://docs.adcrunch.dev/api/campaigns/list-advertiser-campaigns): Available on: Meta TikTok Google Ads OpenAI. Reference for the GET /observe/{advertiserId}/campaigns endpoint in the AdCrunch API.
- [Get one campaign](https://docs.adcrunch.dev/api/campaigns/get-campaign): Available on: Meta TikTok Google Ads OpenAI. Reference for the GET /observe/{advertiserId}/campaigns/{id} endpoint in the AdCrunch API.
- [Create a campaign](https://docs.adcrunch.dev/api/campaigns/create-campaign): Available on: Meta. Reference for the POST /mutations/{advertiserId}/campaigns endpoint in the AdCrunch API.
- [Update a campaign’s status](https://docs.adcrunch.dev/api/campaigns/update-campaign-status): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/campaigns/{id}/status endpoint in the AdCrunch API.
- [Update a campaign’s budget](https://docs.adcrunch.dev/api/campaigns/update-campaign-budget): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/campaigns/{id}/budget endpoint in the AdCrunch API.
- [Update a campaign’s bidding](https://docs.adcrunch.dev/api/campaigns/update-campaign-bidding): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/campaigns/{id}/bidding endpoint in the AdCrunch API.
- [Update a campaign’s name](https://docs.adcrunch.dev/api/campaigns/update-campaign-name): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/campaigns/{id}/name endpoint in the AdCrunch API.
- [Copy a campaign](https://docs.adcrunch.dev/api/campaigns/copy-campaign): Available on: Meta. Reference for the POST /mutations/{advertiserId}/campaigns/{id}/copies endpoint in the AdCrunch API.

### Ad groups

- [List an advertiser’s ad groups](https://docs.adcrunch.dev/api/ad-groups/list-advertiser-ad-groups): Available on: Meta TikTok Google Ads. Reference for the GET /observe/{advertiserId}/ad-groups endpoint in the AdCrunch API.
- [Get one ad group](https://docs.adcrunch.dev/api/ad-groups/get-ad-group): Available on: Meta TikTok Google Ads. Reference for the GET /observe/{advertiserId}/ad-groups/{id} endpoint in the AdCrunch API.
- [Create an ad group](https://docs.adcrunch.dev/api/ad-groups/create-ad-group): Available on: Meta. Reference for the POST /mutations/{advertiserId}/ad-groups endpoint in the AdCrunch API.
- [Update an ad group’s status](https://docs.adcrunch.dev/api/ad-groups/update-ad-group-status): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/ad-groups/{id}/status endpoint in the AdCrunch API.
- [Update an ad group’s budget](https://docs.adcrunch.dev/api/ad-groups/update-ad-group-budget): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/ad-groups/{id}/budget endpoint in the AdCrunch API.
- [Update an ad group’s schedule](https://docs.adcrunch.dev/api/ad-groups/update-ad-group-schedule): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/ad-groups/{id}/schedule endpoint in the AdCrunch API.
- [Update an ad group’s bidding](https://docs.adcrunch.dev/api/ad-groups/update-ad-group-bidding): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/ad-groups/{id}/bidding endpoint in the AdCrunch API.
- [Update an ad group’s name](https://docs.adcrunch.dev/api/ad-groups/update-ad-group-name): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/ad-groups/{id}/name endpoint in the AdCrunch API.
- [Copy an ad group](https://docs.adcrunch.dev/api/ad-groups/copy-ad-group): Available on: Meta. Reference for the POST /mutations/{advertiserId}/ad-groups/{id}/copies endpoint in the AdCrunch API.

### Ads

- [List an advertiser’s ads](https://docs.adcrunch.dev/api/ads/list-advertiser-ads): Available on: Meta TikTok Google Ads. Reference for the GET /observe/{advertiserId}/ads endpoint in the AdCrunch API.
- [Get one ad](https://docs.adcrunch.dev/api/ads/get-ad): Available on: Meta TikTok Google Ads. Reference for the GET /observe/{advertiserId}/ads/{id} endpoint in the AdCrunch API.
- [Show a Meta ad in each placement](https://docs.adcrunch.dev/api/ads/get-ad-preview-of-ad): Available on: Meta. Reference for the GET /observe/{advertiserId}/ads/{id}/previews endpoint in the AdCrunch API.
- [Create an ad](https://docs.adcrunch.dev/api/ads/create-ad): Available on: Meta. Reference for the POST /mutations/{advertiserId}/ads endpoint in the AdCrunch API.
- [Update an ad’s status](https://docs.adcrunch.dev/api/ads/update-ad-status): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/ads/{id}/status endpoint in the AdCrunch API.
- [Update an ad’s name](https://docs.adcrunch.dev/api/ads/update-ad-name): Available on: Meta. Reference for the PATCH /mutations/{advertiserId}/ads/{id}/name endpoint in the AdCrunch API.

### Custom audiences

- [List an advertiser’s Meta Custom Audiences](https://docs.adcrunch.dev/api/custom-audiences/list-advertiser-custom-audiences): Available on: Meta. Reference for the GET /observe/{advertiserId}/custom-audiences endpoint in the AdCrunch API.
- [Create a Custom Audience](https://docs.adcrunch.dev/api/custom-audiences/create-custom-audience): Available on: Meta. Reference for the POST /mutations/{advertiserId}/custom-audiences endpoint in the AdCrunch API.

### Creatives

- [List an advertiser’s creatives](https://docs.adcrunch.dev/api/creatives/list-advertiser-creatives): Available on: Meta. Reference for the GET /observe/{advertiserId}/creatives endpoint in the AdCrunch API.
- [Get one creative](https://docs.adcrunch.dev/api/creatives/get-creative): Available on: Meta. Reference for the GET /observe/{advertiserId}/creatives/{id} endpoint in the AdCrunch API.
- [Show a Meta creative in each placement](https://docs.adcrunch.dev/api/creatives/get-ad-preview-of-creative): Available on: Meta. Reference for the GET /observe/{advertiserId}/creatives/{id}/previews endpoint in the AdCrunch API.
- [Create a creative](https://docs.adcrunch.dev/api/creatives/create-creative): Available on: Meta. Reference for the POST /mutations/{advertiserId}/creatives endpoint in the AdCrunch API.

### Asset groups

- [List an advertiser’s asset groups](https://docs.adcrunch.dev/api/asset-groups/list-advertiser-asset-groups): Available on: Google Ads. Reference for the GET /observe/{advertiserId}/asset-groups endpoint in the AdCrunch API.
- [Get one asset group](https://docs.adcrunch.dev/api/asset-groups/get-asset-group): Available on: Google Ads. Reference for the GET /observe/{advertiserId}/asset-groups/{id} endpoint in the AdCrunch API.

### Pages

- [List an advertiser’s Facebook Pages](https://docs.adcrunch.dev/api/pages/list-advertiser-pages): Available on: Meta. Reference for the GET /observe/{advertiserId}/pages endpoint in the AdCrunch API.

### Pixels

- [List an advertiser’s Meta Pixels](https://docs.adcrunch.dev/api/pixels/list-advertiser-pixels): Available on: Meta. Reference for the GET /observe/{advertiserId}/pixels endpoint in the AdCrunch API.
- [List the events of a Meta Pixel](https://docs.adcrunch.dev/api/pixels/list-pixel-events): Available on: Meta. Reference for the GET /observe/{advertiserId}/pixels/{pixelId}/events endpoint in the AdCrunch API.

### Stored reads

- [List campaigns](https://docs.adcrunch.dev/api/stored-reads/list-campaigns): Available on: Meta TikTok Google Ads OpenAI. Reference for the GET /observe/campaigns endpoint in the AdCrunch API.
- [List ad groups](https://docs.adcrunch.dev/api/stored-reads/list-ad-groups): Available on: Meta TikTok Google Ads OpenAI. Reference for the GET /observe/ad-groups endpoint in the AdCrunch API.
- [List ads](https://docs.adcrunch.dev/api/stored-reads/list-ads): Available on: Meta TikTok Google Ads OpenAI. Reference for the GET /observe/ads endpoint in the AdCrunch API.
- [List creatives](https://docs.adcrunch.dev/api/stored-reads/list-creatives): Available on: Meta. Reference for the GET /observe/creatives endpoint in the AdCrunch API.
- [List asset groups](https://docs.adcrunch.dev/api/stored-reads/list-asset-groups): Available on: Google Ads. Reference for the GET /observe/asset-groups endpoint in the AdCrunch API.

### Custom conversions

- [List an advertiser’s Meta custom conversions](https://docs.adcrunch.dev/api/custom-conversions/list-advertiser-custom-conversions): Available on: Meta. Reference for the GET /observe/{advertiserId}/custom-conversions endpoint in the AdCrunch API.

### Mutations

- [Start a mutation](https://docs.adcrunch.dev/api/mutations/start-mutation): Available on: Meta. Reference for the POST /mutations endpoint in the AdCrunch API.
- [List mutations](https://docs.adcrunch.dev/api/mutations/list-mutations): Lists your organization's Mutations, newest first. Reference for the GET /mutations endpoint in the AdCrunch API.
- [Read a mutation](https://docs.adcrunch.dev/api/mutations/get-mutation-status): Reports how a Mutation ended, or that it has not ended. Reference for the GET /mutations/{id} endpoint in the AdCrunch API.

### Skills

- [List the Skills](https://docs.adcrunch.dev/api/skills/list-skills): Lists the Skills of your organization, newest first. Each row gives the slug, the name,… Reference for the GET /context/skills endpoint in the AdCrunch API.
- [Create a Skill](https://docs.adcrunch.dev/api/skills/create-skill): Creates a Skill in your organization. The body is the playbook itself, and the… Reference for the POST /context/skills endpoint in the AdCrunch API.
- [Get a Skill by slug](https://docs.adcrunch.dev/api/skills/get-skill): Reads one Skill by its slug. The answer has the full body and the current… Reference for the GET /context/skills/{slug} endpoint in the AdCrunch API.
- [Update a Skill](https://docs.adcrunch.dev/api/skills/update-skill): Updates a Skill. Send only the fields you change, with the base_revision you… Reference for the PATCH /context/skills/{slug} endpoint in the AdCrunch API.
- [Delete a Skill](https://docs.adcrunch.dev/api/skills/delete-skill): Deletes a Skill. Send the base_revision you read, in the query string. The… Reference for the DELETE /context/skills/{slug} endpoint in the AdCrunch API.
- [Re-import a Skill](https://docs.adcrunch.dev/api/skills/reimport-skill): Re-imports a Skill that your organization imported from the Skill… Reference for the POST /context/skills/{slug}/re-import endpoint in the AdCrunch API.
- [List the Skill Catalog](https://docs.adcrunch.dev/api/skills/list-skill-catalog): Lists the Skill Catalog: the playbooks that AdCrunch writes, and that your… Reference for the GET /context/skill-catalog endpoint in the AdCrunch API.
- [Get a Catalog Skill](https://docs.adcrunch.dev/api/skills/get-catalog-skill): Reads one Catalog Skill with its body: the playbook that AdCrunch… Reference for the GET /context/skill-catalog/{catalogSlug} endpoint in the AdCrunch API.
- [Import a Catalog Skill](https://docs.adcrunch.dev/api/skills/import-catalog-skill): Imports a Catalog Skill into your organization. The import… Reference for the POST /context/skill-catalog/{catalogSlug}/import endpoint in the AdCrunch API.

### Targeting options

- [Search the Meta interests and job titles](https://docs.adcrunch.dev/api/targeting-options/search-targeting-options): Available on: Meta. Reference for the GET /observe/{advertiserId}/targeting-options endpoint in the AdCrunch API.

### Brands

- [List the Brands](https://docs.adcrunch.dev/api/brands/list-brands): Lists the Brands of your organization, newest first. Each row gives the slug, the name,… Reference for the GET /context/brands endpoint in the AdCrunch API.
- [Create a Brand](https://docs.adcrunch.dev/api/brands/create-brand): Creates a Brand in your organization. The body is optional, because you write a Brand… Reference for the POST /context/brands endpoint in the AdCrunch API.
- [Get a Brand by slug](https://docs.adcrunch.dev/api/brands/get-brand): Reads one Brand by its slug. The answer has its body and the current revision.… Reference for the GET /context/brands/{slug} endpoint in the AdCrunch API.
- [Update a Brand](https://docs.adcrunch.dev/api/brands/update-brand): Updates a Brand. Send the base_revision you read. Omit the body to keep it. Send… Reference for the PATCH /context/brands/{slug} endpoint in the AdCrunch API.
- [Delete a Brand](https://docs.adcrunch.dev/api/brands/delete-brand): Deletes a Brand. Send the base_revision you read, in the query string. The… Reference for the DELETE /context/brands/{slug} endpoint in the AdCrunch API.
- [Add an Assignee to a Brand](https://docs.adcrunch.dev/api/brands/add-brand-assignee): Makes a member an Assignee of a Brand. An Assignee is a current member… Reference for the POST /context/brands/{slug}/assignees endpoint in the AdCrunch API.
- [Remove an Assignee of a Brand](https://docs.adcrunch.dev/api/brands/remove-brand-assignee): Removes an Assignee of a Brand. An Assignee is a current… Reference for the DELETE /context/brands/{slug}/assignees/{person} endpoint in the AdCrunch API.
- [List a Brand's advertisers](https://docs.adcrunch.dev/api/brands/list-brand-advertisers): Lists the advertisers attached to a Brand, newest first. Each row… Reference for the GET /context/brands/{slug}/advertisers endpoint in the AdCrunch API.
- [Attach an advertiser](https://docs.adcrunch.dev/api/brands/attach-brand-advertiser): Attaches an advertiser to a Brand. An agent that works on that… Reference for the POST /context/brands/{slug}/advertisers endpoint in the AdCrunch API.
- [Detach an advertiser](https://docs.adcrunch.dev/api/brands/detach-brand-advertiser): Detaches an advertiser from a Brand. This brand… Reference for the DELETE /context/brands/{slug}/advertisers/{advertiserId} endpoint in the AdCrunch API.

### Personas

- [List a Brand's Personas](https://docs.adcrunch.dev/api/personas/list-personas): Lists a Brand's Personas, newest first, as slug + name + description +… Reference for the GET /context/brands/{slug}/personas endpoint in the AdCrunch API.
- [Create a Persona](https://docs.adcrunch.dev/api/personas/create-persona): Creates a Persona on a Brand. A Persona describes one audience that the… Reference for the POST /context/brands/{slug}/personas endpoint in the AdCrunch API.
- [Get a Persona](https://docs.adcrunch.dev/api/personas/get-persona): Reads one Persona by its Brand slug and its own slug. The… Reference for the GET /context/brands/{slug}/personas/{personaSlug} endpoint in the AdCrunch API.
- [Update a Persona](https://docs.adcrunch.dev/api/personas/update-persona): Updates a Persona. Send the base_revision you read. Omit… Reference for the PATCH /context/brands/{slug}/personas/{personaSlug} endpoint in the AdCrunch API.
- [Delete a Persona](https://docs.adcrunch.dev/api/personas/delete-persona): Deletes a Persona. Send the base_revision you read, in… Reference for the DELETE /context/brands/{slug}/personas/{personaSlug} endpoint in the AdCrunch API.

### Documents

- [List a Brand's documents](https://docs.adcrunch.dev/api/documents/list-brand-documents): Lists the documents of a Brand, newest first. Each row has a URL to read… Reference for the GET /context/brands/{slug}/documents endpoint in the AdCrunch API.
- [Start a document upload](https://docs.adcrunch.dev/api/documents/create-brand-document-upload): Reserves a document on a Brand, and is the first of the three steps of… Reference for the POST /context/brands/{slug}/documents endpoint in the AdCrunch API.
- [Finalize a document upload](https://docs.adcrunch.dev/api/documents/finalize-brand-document): Completes a reserved document after you send the… Reference for the POST /context/brands/{slug}/documents/{documentId}/finalize endpoint in the AdCrunch API.
- [Get a document](https://docs.adcrunch.dev/api/documents/get-brand-document): Reads one document of a Brand. The answer has the document… Reference for the GET /context/brands/{slug}/documents/{documentId} endpoint in the AdCrunch API.
- [Delete a document](https://docs.adcrunch.dev/api/documents/delete-brand-document): Deletes a document and its bytes. This operation takes… Reference for the DELETE /context/brands/{slug}/documents/{documentId} endpoint in the AdCrunch API.

### Campaign Plans

- [List the Campaign Plans](https://docs.adcrunch.dev/api/campaign-plans/list-campaign-plans): Lists the Campaign Plans of your organization, newest first. Each row gives the… Reference for the GET /context/campaign-plans endpoint in the AdCrunch API.
- [Create a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/create-campaign-plan): Creates a Campaign Plan. A Campaign Plan is the AdCrunch planning document. It… Reference for the POST /context/campaign-plans endpoint in the AdCrunch API.
- [Get a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/get-campaign-plan): Reads one Campaign Plan. The answer gives the number of its Line Items in… Reference for the GET /context/campaign-plans/{slug} endpoint in the AdCrunch API.
- [Update a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/update-campaign-plan): Updates a Campaign Plan. Send the base_revision you read. Omit a field… Reference for the PATCH /context/campaign-plans/{slug} endpoint in the AdCrunch API.
- [Delete a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/delete-campaign-plan): Deletes a Campaign Plan and its Line Items. Send the base_revision you… Reference for the DELETE /context/campaign-plans/{slug} endpoint in the AdCrunch API.
- [Approve a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/approve-campaign-plan): Approves a Campaign Plan and validates its draft Line Items. An… Reference for the POST /context/campaign-plans/{slug}/approve endpoint in the AdCrunch API.
- [Duplicate a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/duplicate-campaign-plan): Duplicates a Campaign Plan: one new Campaign Plan, with a copy… Reference for the POST /context/campaign-plans/{slug}/duplicate endpoint in the AdCrunch API.
- [Get the delivery of a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/get-campaign-plan-delivery): Reads what each Line Item of a Campaign Plan delivered. AdCrunch… Reference for the GET /context/campaign-plans/{slug}/delivery endpoint in the AdCrunch API.
- [List the Comments of a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/list-campaign-plan-comments): Lists the Comments of a Campaign Plan, by thread, newest thread… Reference for the GET /context/campaign-plans/{slug}/comments endpoint in the AdCrunch API.
- [Post a Comment on a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/create-campaign-plan-comment): Posts a Comment on a Campaign Plan, or a reply in one of its… Reference for the POST /context/campaign-plans/{slug}/comments endpoint in the AdCrunch API.
- [Edit a Comment of a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/edit-campaign-plan-comment): Replaces the text of a Comment, and sets editedAt.… Reference for the PATCH /context/campaign-plans/{slug}/comments/{comment_id} endpoint in the AdCrunch API.
- [Delete a Comment of a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/delete-campaign-plan-comment): Deletes a Comment. Only its author can delete it.… Reference for the DELETE /context/campaign-plans/{slug}/comments/{comment_id} endpoint in the AdCrunch API.
- [Add an Assignee to a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/add-campaign-plan-assignee): Makes a member an Assignee of a Campaign Plan. An Assignee is a… Reference for the POST /context/campaign-plans/{slug}/assignees endpoint in the AdCrunch API.
- [Remove an Assignee of a Campaign Plan](https://docs.adcrunch.dev/api/campaign-plans/remove-campaign-plan-assignee): Removes an Assignee of a Campaign Plan. An Assignee… Reference for the DELETE /context/campaign-plans/{slug}/assignees/{person} endpoint in the AdCrunch API.

### Line Items

- [Add a Line Item](https://docs.adcrunch.dev/api/line-items/create-line-item): Adds a Line Item to a Campaign Plan. One Line Item is one… Reference for the POST /context/campaign-plans/{slug}/line-items endpoint in the AdCrunch API.
- [List the Line Items of a Campaign Plan](https://docs.adcrunch.dev/api/line-items/list-line-items): Lists the Line Items of a Campaign Plan, newest first. Each row… Reference for the GET /context/campaign-plans/{slug}/line-items endpoint in the AdCrunch API.
- [Update a Line Item](https://docs.adcrunch.dev/api/line-items/update-line-item): Updates a Line Item. Send the base_revision you… Reference for the PATCH /context/campaign-plans/{slug}/line-items/{lineItemId} endpoint in the AdCrunch API.
- [Delete a Line Item](https://docs.adcrunch.dev/api/line-items/delete-line-item): Deletes a Line Item. Send the base_revision you… Reference for the DELETE /context/campaign-plans/{slug}/line-items/{lineItemId} endpoint in the AdCrunch API.
- [Get a Line Item](https://docs.adcrunch.dev/api/line-items/get-line-item): Reads one Line Item with its readiness: whether… Reference for the GET /context/campaign-plans/{slug}/line-items/{lineItemId} endpoint in the AdCrunch API.
- [Validate a Line Item](https://docs.adcrunch.dev/api/line-items/validate-line-item): Validates one Line Item. Use this call… Reference for the POST /context/campaign-plans/{slug}/line-items/{lineItemId}/validate endpoint in the AdCrunch API.
- [Get the delivery series of a Line Item](https://docs.adcrunch.dev/api/line-items/get-line-item-delivery-series): Reads the spend of a Line Item day by… Reference for the GET /context/campaign-plans/{slug}/line-items/{lineItemId}/delivery endpoint in the AdCrunch API.
- [Record what a Line Item spawned](https://docs.adcrunch.dev/api/line-items/record-line-item-execution): Records one provider object that this… Reference for the POST /context/campaign-plans/{slug}/line-items/{lineItemId}/executions endpoint in the AdCrunch API.

### Assets

- [List the organization Assets](https://docs.adcrunch.dev/api/assets/list-assets): Lists the active organization's Assets, newest first. Each row carries its Registrations, so one… Reference for the GET /assets endpoint in the AdCrunch API.
- [Create an Asset from raw bytes](https://docs.adcrunch.dev/api/assets/create-asset): Creates an Asset in one of two ways. The Content-Type of the request picks one. Reference for the POST /assets endpoint in the AdCrunch API.
- [Reserve an Asset and mint an upload URL](https://docs.adcrunch.dev/api/assets/create-asset-upload): Reserves an Asset and returns a presigned PUT URL to upload the bytes to. The URL is… Reference for the POST /assets/uploads endpoint in the AdCrunch API.
- [Get one Asset](https://docs.adcrunch.dev/api/assets/get-asset): Fetches one Asset in any status (pending, ready or failed), with its Registrations and a… Reference for the GET /assets/{id} endpoint in the AdCrunch API.
- [Rename an Asset](https://docs.adcrunch.dev/api/assets/rename-asset): Renames an Asset. The name is what the console shows and what a provider receives at… Reference for the PATCH /assets/{id} endpoint in the AdCrunch API.
- [Delete an Asset](https://docs.adcrunch.dev/api/assets/delete-asset): Deletes our copy of the bytes and removes the Asset from the library. A reservation can… Reference for the DELETE /assets/{id} endpoint in the AdCrunch API.
- [Register an Asset to an advertiser](https://docs.adcrunch.dev/api/assets/register-asset): Available on: Meta TikTok. Reference for the POST /assets/{id}/registrations endpoint in the AdCrunch API.

## Agent resources

- [llms-full.txt](https://docs.adcrunch.dev/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.adcrunch.dev/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [API catalog](https://docs.adcrunch.dev/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [agent-readability.json](https://docs.adcrunch.dev/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.adcrunch.dev/sitemap.xml): Every indexable page URL with its last-modified date.