create_microsoft_campaign_criterions

Add DEEP campaign-level targeting (same criterion types as ad-group targeting) to an existing campaign

Endpoint

Headers

Description

Add DEEP campaign-level targeting (same criterion types as ad-group targeting) to an existing campaign. Include/exclude + bid adjustments. Merges onto existing campaign targeting. Mutates a live entity.

Request body

Field	Type	Description
`account_id`	`string` optional	Microsoft Advertising ad account id (numeric AccountId — NOT the 8-character account number shown in the UI). Get it from list_microsoft_accounts. Required when more than one account is connected; may be omitted with exactly one. `customer_id` is accepted as an alias. If the tool replies that several accounts are connected, re-run with this set — that reply is NOT a connection problem.
`customer_id`	`string` optional	Alias of account_id.
`campaign_id`	`string` required	The EXISTING campaign to add campaign-level targeting to (required).
`criterions`	`array` required	Targeting criterions to add. Each: {criterion_type (one of: age, gender, daytime, device, location, radius, location_intent, audience, profile, webpage), plus its fields, plus optional negative:true to EXCLUDE and bid_multiplier (a % adjustment like 20 or -15 for age/gender/daytime/device/location/radius/audience/profile) or bid_amount (a fixed bid for webpage). Fields per type: age {age_range: EighteenToTwentyFour\|TwentyFiveToThirtyFour\|ThirtyFiveToFourtyNine\|FiftyToSixtyFour\|SixtyFiveAndAbove}; gender {gender_type: Male\|Female\|Unknown}; daytime {day: Monday.., from_hour 0-23, to_hour 0-24, from_minute/to_minute: Zero\|Fifteen\|Thirty\|FortyFive}; device {device_name: Computers\|Smartphones\|Tablets — add all 3 together}; location {location_id (from Microsoft geo ids)}; radius {latitude, longitude, radius, radius_unit: Miles\|Kilometers}; location_intent {intent_option: PeopleIn\|PeopleInOrSearchingForOrViewingPages}; audience {audience_id (from create_microsoft_audiences / list_microsoft_audiences)}; profile {profile_id, profile_type: CompanyName\|Industry\|JobFunction\|JobSeniority\|JobTitle}; webpage (DSA) {criterion_name, conditions:[{operand: Url\|Category\|PageTitle\|PageContent\|CustomLabel, operator: Contains\|Equals, argument}]}. ⛔ Adding APPENDS — existing targeting is untouched (never wholesale-replaced).}

Field

Type

Description

account_id

string optional

Microsoft Advertising ad account id (numeric AccountId — NOT the 8-character account number shown in the UI). Get it from list_microsoft_accounts. Required when more than one account is connected; may be omitted with exactly one. `customer_id` is accepted as an alias. If the tool replies that several accounts are connected, re-run with this set — that reply is NOT a connection problem.

customer_id

string optional

Alias of account_id.

campaign_id

string required

The EXISTING campaign to add campaign-level targeting to (required).

criterions

array required

Targeting criterions to add. Each: {criterion_type (one of: age, gender, daytime, device, location, radius, location_intent, audience, profile, webpage), plus its fields, plus optional negative:true to EXCLUDE and bid_multiplier (a % adjustment like 20 or -15 for age/gender/daytime/device/location/radius/audience/profile) or bid_amount (a fixed bid for webpage). Fields per type: age {age_range: EighteenToTwentyFour|TwentyFiveToThirtyFour|ThirtyFiveToFourtyNine|FiftyToSixtyFour|SixtyFiveAndAbove}; gender {gender_type: Male|Female|Unknown}; daytime {day: Monday.., from_hour 0-23, to_hour 0-24, from_minute/to_minute: Zero|Fifteen|Thirty|FortyFive}; device {device_name: Computers|Smartphones|Tablets — add all 3 together}; location {location_id (from Microsoft geo ids)}; radius {latitude, longitude, radius, radius_unit: Miles|Kilometers}; location_intent {intent_option: PeopleIn|PeopleInOrSearchingForOrViewingPages}; audience {audience_id (from create_microsoft_audiences / list_microsoft_audiences)}; profile {profile_id, profile_type: CompanyName|Industry|JobFunction|JobSeniority|JobTitle}; webpage (DSA) {criterion_name, conditions:[{operand: Url|Category|PageTitle|PageContent|CustomLabel, operator: Contains|Equals, argument}]}. ⛔ Adding APPENDS — existing targeting is untouched (never wholesale-replaced).}

Example request

Example responses

200 — Success

{ "success": true, "data": { "text": "(tool-specific textual output for create_microsoft_campaign_criterions)", "quota": { "used": 42, "limit": 150, "tier": "plus", "period_end": "2026-05-01" } }, "tool": "create_microsoft_campaign_criterions" }

400 — Tool-level error (bad arguments / multi-account selection)

{ "success": false, "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")", "is_error": true, "tool": "create_microsoft_campaign_criterions" }

402 — Quota exhausted

{ "success": false, "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.", "is_error": true, "tool": "create_microsoft_campaign_criterions", "quota": { "used": 150, "limit": 150, "tier": "plus", "period_end": "2026-05-01", "upgrade_url": "https://adspirer.ai" } }

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: Microsoft Advertising · All tools