create_adset
Create a new Meta Ads ad set with specified targeting, optimization goals, and budget. Define campaign parameters like status, bid strategy, and billing event to optimize ad delivery for Facebook and Instagram platforms.
Instructions
Create a new ad set in a Meta Ads account.
Args:
account_id: Meta Ads account ID (format: act_XXXXXXXXX)
campaign_id: Meta Ads campaign ID this ad set belongs to
name: Ad set name
status: Initial ad set status (default: PAUSED)
daily_budget: Daily budget in account currency (in cents) as a string
lifetime_budget: Lifetime budget in account currency (in cents) as a string
targeting: Targeting specifications including age, location, interests, etc.
Use targeting_automation.advantage_audience=1 for automatic audience finding
optimization_goal: Conversion optimization goal (e.g., 'LINK_CLICKS', 'REACH', 'CONVERSIONS', 'APP_INSTALLS')
billing_event: How you're charged (e.g., 'IMPRESSIONS', 'LINK_CLICKS')
bid_amount: Bid amount in account currency (in cents)
bid_strategy: Bid strategy (e.g., 'LOWEST_COST', 'LOWEST_COST_WITH_BID_CAP')
start_time: Start time in ISO 8601 format (e.g., '2023-12-01T12:00:00-0800')
end_time: End time in ISO 8601 format
dsa_beneficiary: DSA beneficiary (person/organization benefiting from ads) for European compliance
promoted_object: Mobile app configuration for APP_INSTALLS campaigns. Required fields: application_id, object_store_url.
Optional fields: custom_event_type, pixel_id, page_id.
Example: {"application_id": "123456789012345", "object_store_url": "https://apps.apple.com/app/id123456789"}
destination_type: Where users are directed after clicking the ad (e.g., 'APP_STORE', 'DEEPLINK', 'APP_INSTALL', 'ON_AD').
Required for mobile app campaigns and lead generation campaigns.
Use 'ON_AD' for lead generation campaigns where user interaction happens within the ad.
access_token: Meta API access token (optional - will use cached token if not provided)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| access_token | No | ||
| account_id | No | ||
| bid_amount | No | ||
| bid_strategy | No | ||
| billing_event | No | ||
| campaign_id | No | ||
| daily_budget | No | ||
| destination_type | No | ||
| dsa_beneficiary | No | ||
| end_time | No | ||
| lifetime_budget | No | ||
| name | No | ||
| optimization_goal | No | ||
| promoted_object | No | ||
| start_time | No | ||
| status | No | PAUSED | |
| targeting | No |
Input Schema (JSON Schema)
{
"properties": {
"access_token": {
"default": null,
"title": "Access Token",
"type": "string"
},
"account_id": {
"default": null,
"title": "Account Id",
"type": "string"
},
"bid_amount": {
"default": null,
"title": "bid_amount",
"type": "string"
},
"bid_strategy": {
"default": null,
"title": "Bid Strategy",
"type": "string"
},
"billing_event": {
"default": null,
"title": "Billing Event",
"type": "string"
},
"campaign_id": {
"default": null,
"title": "Campaign Id",
"type": "string"
},
"daily_budget": {
"default": null,
"title": "daily_budget",
"type": "string"
},
"destination_type": {
"default": null,
"title": "Destination Type",
"type": "string"
},
"dsa_beneficiary": {
"default": null,
"title": "Dsa Beneficiary",
"type": "string"
},
"end_time": {
"default": null,
"title": "End Time",
"type": "string"
},
"lifetime_budget": {
"default": null,
"title": "lifetime_budget",
"type": "string"
},
"name": {
"default": null,
"title": "Name",
"type": "string"
},
"optimization_goal": {
"default": null,
"title": "Optimization Goal",
"type": "string"
},
"promoted_object": {
"additionalProperties": true,
"default": null,
"title": "Promoted Object",
"type": "object"
},
"start_time": {
"default": null,
"title": "Start Time",
"type": "string"
},
"status": {
"default": "PAUSED",
"title": "Status",
"type": "string"
},
"targeting": {
"additionalProperties": true,
"default": null,
"title": "Targeting",
"type": "object"
}
},
"title": "create_adsetArguments",
"type": "object"
}