meta_create_adset

Create a Meta ad set under a campaign, with its audience and its optimization goal. It always arrives paused.

Ask for an ad set under a campaign: the countries, the ages, the interests and the job titles, the Custom Audiences to include or to exclude, whether Meta can reach people outside your targeting (Advantage+ audience), what delivery optimizes for, and how Meta bids if you want to choose. An ad set can optimize for a standard event or for a custom conversion. AdCrunch creates it paused.

Add an ad set to Spring Prospecting that targets France and Belgium, ages 25 to 54 without Advantage+ audience, and optimizes for purchases on the Northwind Web Pixel.

The agent calls meta_create_adset, then get_mutation_status, and you see the id of the new paused ad set. For interests and job titles, the agent first finds their ids with meta_search_targeting. Change what runs on Meta walks the whole campaign.

Reference

Available on:

Create an ad set under a Meta campaign on a live ad account. It is always created PAUSED and cannot be created active. Targeting is countries, an age range, gender, interests and job titles (interests, workPositions), and Custom Audiences to include or to exclude — placements are left to Meta’s automatic default. Find the id of an interest or a job title with meta_search_targeting. advantageAudience is required. Its description gives the age rules that go with it. Ask the user when you do not know. Whether a budget is required depends on the parent campaign: if it uses Advantage campaign budget, the ad set must NOT carry one; otherwise it must carry exactly one. Optionally set how Meta bids: bidStrategy, with the one amount it takes (bidCap, costCap or roasFloor). Under a campaign that holds the bid strategy, give the same strategy, with the amount for this ad set. Give pixelId and customEventType when the optimization goal optimizes toward conversions (find a pixel with meta_list_pixels). To optimize for a custom conversion, give customConversionId in place of customEventType (find one with meta_list_custom_conversions). Runs asynchronously: returns a mutationId — call get_mutation_status with it to get the new ad set’s id.

Input

Output

A successful call returns this object in structuredContent.

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

• not_found
• provider_not_connected
• missing_write_access
• organization_unentitled
• forbidden
• invalid_request
• internal_error

Scope

The token must hold mutation:write. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

• Writes. The tool can change data.
• Destructive. The tool can make a change that you cannot undo. A client can ask you to confirm before it calls the tool.
• Not idempotent. A second call with the same arguments can change more.
• Open world. The tool reaches a system outside AdCrunch, such as an ad platform.

Example

The arguments:

{
  "advantageAudience": false,
  "advertiserId": "acc_1485443900032333",
  "ageMax": 54,
  "ageMin": 25,
  "campaignId": "120215678901234567",
  "countries": [
    "FR",
    "BE"
  ],
  "customEventType": "PURCHASE",
  "name": "FR BE 25-54 Purchases",
  "optimizationGoal": "OFFSITE_CONVERSIONS",
  "pixelId": "812345678901234"
}

The result, in structuredContent:

{
  "consoleUrl": "https://console.adcrunch.dev/activity/mut_k3x9q2v7m4n8p1r5t6w0y2z4",
  "mutationId": "mut_k3x9q2v7m4n8p1r5t6w0y2z4"
}