meta-ads-manager

Meta Ads Manager - manage Facebook and Instagram advertising campaigns, ad sets, ads, and view performance insights

Server path: /meta-ads-manager | Type: Application | PCID required: Yes

Tools

Tool	Description
meta_ads_manager_create_ad	Create ad
meta_ads_manager_create_ad_set	Create ad set
meta_ads_manager_create_campaign	Create campaign
meta_ads_manager_delete_ad	Delete ad
meta_ads_manager_delete_ad_set	Delete ad set
meta_ads_manager_delete_campaign	Delete campaign
meta_ads_manager_dissociate_campaigns	Dissociate campaigns
meta_ads_manager_get_account_insights	Get account insights
meta_ads_manager_get_ad	Get ad
meta_ads_manager_get_ad_set	Get ad set
meta_ads_manager_get_campaign	Get campaign
meta_ads_manager_get_campaign_insights	Get campaign insights
meta_ads_manager_list_ad_sets	List ad sets
meta_ads_manager_list_ads	List ads
meta_ads_manager_list_campaigns	List campaigns
meta_ads_manager_update_ad	Update ad
meta_ads_manager_update_ad_set	Update ad set
meta_ads_manager_update_campaign	Update campaign

---

meta_ads_manager_create_ad

Create ad

Parameters:

Parameter	Type	Required	Default	Description
ad_account_id	string	Yes	—	ID of the ad account.
name	string	Yes	—	Name of the ad.
adset_id	string	Yes	—	The ID of the ad set to associate with this ad.
creative	string	Yes	—	Ad creative spec as JSON string, e.g. {“creative_id”:“<CREATIVE_ID>”} or inline creative spec.
status	string	No	—	Ad status. Only ACTIVE and PAUSED are valid during creation.
bid_amount	integer	No	—	Bid amount in account currency subunits. Overrides the ad set bid_amount.
tracking_specs	string	No	—	Tracking specs as JSON string for logging actions taken on your ad.
conversion_domain	string	No	—	Domain where conversions happen. Required for campaigns that share data with a pixel.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_account_id": {
      "type": "string",
      "description": "ID of the ad account."
    },
    "name": {
      "type": "string",
      "description": "Name of the ad."
    },
    "adset_id": {
      "type": "string",
      "description": "The ID of the ad set to associate with this ad."
    },
    "creative": {
      "type": "string",
      "description": "Ad creative spec as JSON string, e.g. {\"creative_id\":\"<CREATIVE_ID>\"} or inline creative spec."
    },
    "status": {
      "type": "string",
      "description": "Ad status. Only ACTIVE and PAUSED are valid during creation.",
      "enum": [
        "ACTIVE",
        "PAUSED"
      ]
    },
    "bid_amount": {
      "type": "integer",
      "description": "Bid amount in account currency subunits. Overrides the ad set bid_amount."
    },
    "tracking_specs": {
      "type": "string",
      "description": "Tracking specs as JSON string for logging actions taken on your ad."
    },
    "conversion_domain": {
      "type": "string",
      "description": "Domain where conversions happen. Required for campaigns that share data with a pixel."
    }
  },
  "required": [
    "PCID",
    "ad_account_id",
    "name",
    "adset_id",
    "creative"
  ]
}

---

meta_ads_manager_create_ad_set

Create ad set

Parameters:

Parameter	Type	Required	Default	Description
ad_account_id	string	Yes	—	ID of the ad account.
name	string	Yes	—	Ad set name, max length of 400 characters.
campaign_id	string	Yes	—	The campaign ID to add this ad set to.
billing_event	string	Yes	—	The billing event for this ad set.
optimization_goal	string	No	—	What the ad set is optimizing for.
bid_amount	integer	No	—	Bid cap or target cost for this ad set in account currency subunits.
bid_strategy	string	No	—	Bid strategy for this ad set.
daily_budget	integer	No	—	Daily budget in account currency subunits.
lifetime_budget	integer	No	—	Lifetime budget in account currency subunits.
start_time	string	No	—	Start time of the ad set (ISO 8601 format).
end_time	string	No	—	End time of the ad set (ISO 8601 format). Required when lifetime_budget is specified.
targeting	string	No	—	Targeting spec as JSON string. Must include geo_locations with countries array, e.g. {“geo_locations”:{“countries”:[“US”]}}.
status	string	No	—	Ad set status. Only ACTIVE and PAUSED are valid during creation.
destination_type	string	No	—	Where people are sent when they click.
pacing_type	string	No	—	Defines the pacing type. Pass as JSON array string (for example, [“standard”]).
adset_schedule	string	No	—	Ad set delivery schedule for specific days/hours. Pass as JSON array string of schedule objects.
attribution_spec	string	No	—	Conversion attribution settings for optimization. Pass as JSON array string of attribution objects.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_account_id": {
      "type": "string",
      "description": "ID of the ad account."
    },
    "name": {
      "type": "string",
      "description": "Ad set name, max length of 400 characters."
    },
    "campaign_id": {
      "type": "string",
      "description": "The campaign ID to add this ad set to."
    },
    "billing_event": {
      "type": "string",
      "description": "The billing event for this ad set.",
      "enum": [
        "APP_INSTALLS",
        "CLICKS",
        "IMPRESSIONS",
        "LINK_CLICKS",
        "NONE",
        "OFFER_CLAIMS",
        "PAGE_LIKES",
        "POST_ENGAGEMENT",
        "THRUPLAY",
        "PURCHASE",
        "LISTING_INTERACTION"
      ]
    },
    "optimization_goal": {
      "type": "string",
      "description": "What the ad set is optimizing for.",
      "enum": [
        "NONE",
        "APP_INSTALLS",
        "AD_RECALL_LIFT",
        "ENGAGED_USERS",
        "EVENT_RESPONSES",
        "IMPRESSIONS",
        "LEAD_GENERATION",
        "QUALITY_LEAD",
        "LINK_CLICKS",
        "OFFSITE_CONVERSIONS",
        "PAGE_LIKES",
        "POST_ENGAGEMENT",
        "QUALITY_CALL",
        "REACH",
        "LANDING_PAGE_VIEWS",
        "VISIT_INSTAGRAM_PROFILE",
        "VALUE",
        "THRUPLAY",
        "DERIVED_EVENTS",
        "APP_INSTALLS_AND_OFFSITE_CONVERSIONS",
        "CONVERSATIONS"
      ]
    },
    "bid_amount": {
      "type": "integer",
      "description": "Bid cap or target cost for this ad set in account currency subunits."
    },
    "bid_strategy": {
      "type": "string",
      "description": "Bid strategy for this ad set.",
      "enum": [
        "LOWEST_COST_WITHOUT_CAP",
        "LOWEST_COST_WITH_BID_CAP",
        "COST_CAP"
      ]
    },
    "daily_budget": {
      "type": "integer",
      "description": "Daily budget in account currency subunits."
    },
    "lifetime_budget": {
      "type": "integer",
      "description": "Lifetime budget in account currency subunits."
    },
    "start_time": {
      "type": "string",
      "description": "Start time of the ad set (ISO 8601 format)."
    },
    "end_time": {
      "type": "string",
      "description": "End time of the ad set (ISO 8601 format). Required when lifetime_budget is specified."
    },
    "targeting": {
      "type": "string",
      "description": "Targeting spec as JSON string. Must include geo_locations with countries array, e.g. {\"geo_locations\":{\"countries\":[\"US\"]}}."
    },
    "status": {
      "type": "string",
      "description": "Ad set status. Only ACTIVE and PAUSED are valid during creation.",
      "enum": [
        "ACTIVE",
        "PAUSED"
      ]
    },
    "destination_type": {
      "type": "string",
      "description": "Where people are sent when they click.",
      "enum": [
        "UNDEFINED",
        "WEBSITE",
        "APP",
        "MESSENGER",
        "APPLINKS_AUTOMATIC",
        "FACEBOOK"
      ]
    },
    "pacing_type": {
      "type": "string",
      "description": "Defines the pacing type. Pass as JSON array string (for example, [\"standard\"])."
    },
    "adset_schedule": {
      "type": "string",
      "description": "Ad set delivery schedule for specific days/hours. Pass as JSON array string of schedule objects."
    },
    "attribution_spec": {
      "type": "string",
      "description": "Conversion attribution settings for optimization. Pass as JSON array string of attribution objects."
    }
  },
  "required": [
    "PCID",
    "ad_account_id",
    "name",
    "campaign_id",
    "billing_event"
  ]
}

---

meta_ads_manager_create_campaign

Create campaign

Parameters:

Parameter	Type	Required	Default	Description
ad_account_id	string	Yes	—	ID of the ad account.
name	string	Yes	—	Name for this campaign.
objective	string	Yes	—	Campaign objective.
status	string	No	—	Campaign status. Only ACTIVE and PAUSED are valid during creation.
special_ad_categories	string	Yes	—	Special ad categories. Required for all campaigns. Pass as JSON array string, e.g. [“NONE”]. Valid values: NONE, EMPLOYMENT, HOUSING, CREDIT, ISSUES_ELECTIONS_POLITICS, ONLINE_GAMBLING_AND_GAMING.
buying_type	string	No	—	Buying type: AUCTION (default) or RESERVED (for reach and frequency).
bid_strategy	string	No	—	Bid strategy for this campaign.
daily_budget	integer	No	—	Daily budget in account currency subunits (e.g. cents).
lifetime_budget	integer	No	—	Lifetime budget in account currency subunits.
spend_cap	integer	No	—	Spend cap in account currency subunits (minimum $100 USD equivalent).
start_time	string	No	—	Campaign start time (ISO 8601 format).
stop_time	string	No	—	Campaign stop time (ISO 8601 format).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_account_id": {
      "type": "string",
      "description": "ID of the ad account."
    },
    "name": {
      "type": "string",
      "description": "Name for this campaign."
    },
    "objective": {
      "type": "string",
      "description": "Campaign objective.",
      "enum": [
        "OUTCOME_AWARENESS",
        "OUTCOME_ENGAGEMENT",
        "OUTCOME_LEADS",
        "OUTCOME_SALES",
        "OUTCOME_TRAFFIC",
        "OUTCOME_APP_PROMOTION"
      ]
    },
    "status": {
      "type": "string",
      "description": "Campaign status. Only ACTIVE and PAUSED are valid during creation.",
      "enum": [
        "ACTIVE",
        "PAUSED"
      ]
    },
    "special_ad_categories": {
      "type": "string",
      "description": "Special ad categories. Required for all campaigns. Pass as JSON array string, e.g. [\"NONE\"]. Valid values: NONE, EMPLOYMENT, HOUSING, CREDIT, ISSUES_ELECTIONS_POLITICS, ONLINE_GAMBLING_AND_GAMING."
    },
    "buying_type": {
      "type": "string",
      "description": "Buying type: AUCTION (default) or RESERVED (for reach and frequency).",
      "enum": [
        "AUCTION",
        "RESERVED"
      ]
    },
    "bid_strategy": {
      "type": "string",
      "description": "Bid strategy for this campaign.",
      "enum": [
        "LOWEST_COST_WITHOUT_CAP",
        "LOWEST_COST_WITH_BID_CAP",
        "COST_CAP"
      ]
    },
    "daily_budget": {
      "type": "integer",
      "description": "Daily budget in account currency subunits (e.g. cents)."
    },
    "lifetime_budget": {
      "type": "integer",
      "description": "Lifetime budget in account currency subunits."
    },
    "spend_cap": {
      "type": "integer",
      "description": "Spend cap in account currency subunits (minimum $100 USD equivalent)."
    },
    "start_time": {
      "type": "string",
      "description": "Campaign start time (ISO 8601 format)."
    },
    "stop_time": {
      "type": "string",
      "description": "Campaign stop time (ISO 8601 format)."
    }
  },
  "required": [
    "PCID",
    "ad_account_id",
    "name",
    "objective",
    "special_ad_categories"
  ]
}

---

meta_ads_manager_delete_ad

Delete ad

Parameters:

Parameter	Type	Required	Default	Description
ad_id	string	Yes	—	ID of the ad.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_id": {
      "type": "string",
      "description": "ID of the ad."
    }
  },
  "required": [
    "PCID",
    "ad_id"
  ]
}

---

meta_ads_manager_delete_ad_set

Delete ad set

Parameters:

Parameter	Type	Required	Default	Description
ad_set_id	string	Yes	—	ID of the ad set.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_set_id": {
      "type": "string",
      "description": "ID of the ad set."
    }
  },
  "required": [
    "PCID",
    "ad_set_id"
  ]
}

---

meta_ads_manager_delete_campaign

Delete campaign

Parameters:

Parameter	Type	Required	Default	Description
campaign_id	string	Yes	—	ID of the campaign.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "campaign_id": {
      "type": "string",
      "description": "ID of the campaign."
    }
  },
  "required": [
    "PCID",
    "campaign_id"
  ]
}

---

meta_ads_manager_dissociate_campaigns

Dissociate campaigns

Parameters:

Parameter	Type	Required	Default	Description
ad_account_id	string	Yes	—	ID of the ad account.
delete_strategy	string	Yes	—	Delete strategy to use.
before_date	string	No	—	Delete campaigns before this date (used with DELETE_ARCHIVED_BEFORE strategy).
object_count	integer	No	—	Number of objects to delete.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_account_id": {
      "type": "string",
      "description": "ID of the ad account."
    },
    "delete_strategy": {
      "type": "string",
      "description": "Delete strategy to use.",
      "enum": [
        "DELETE_ANY",
        "DELETE_OLDEST",
        "DELETE_ARCHIVED_BEFORE"
      ]
    },
    "before_date": {
      "type": "string",
      "description": "Delete campaigns before this date (used with DELETE_ARCHIVED_BEFORE strategy)."
    },
    "object_count": {
      "type": "integer",
      "description": "Number of objects to delete."
    }
  },
  "required": [
    "PCID",
    "ad_account_id",
    "delete_strategy"
  ]
}

---

meta_ads_manager_get_account_insights

Get account insights

Parameters:

Parameter	Type	Required	Default	Description
ad_account_id	string	Yes	—	ID of the ad account.
date_preset	string	No	—	Predefined date range for insights.
time_range	object	No	—	Custom date range for insights.
time_increment	string	No	—	How to break down results by time: 1 for daily, 7 for weekly, monthly, or all_days.
fields	string	Yes	—	Comma-separated metrics to return (e.g. impressions,clicks,spend,cpc,cpm,ctr,reach,frequency). Pass as comma-separated string.
level	string	No	—	Level of aggregation for results.
breakdowns	string	No	—	How to break down results (e.g. age,gender,country,placement). Pass as comma-separated string.
filtering	string	No	—	Filters for the report as JSON array, e.g. [{“field”:“campaign.id”,“operator”:“IN”,“value”:[“123”]}].
limit	integer	No	—	Maximum number of results to return.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_account_id": {
      "type": "string",
      "description": "ID of the ad account."
    },
    "date_preset": {
      "type": "string",
      "description": "Predefined date range for insights.",
      "enum": [
        "today",
        "yesterday",
        "this_month",
        "last_month",
        "this_quarter",
        "maximum",
        "last_3d",
        "last_7d",
        "last_14d",
        "last_28d",
        "last_30d",
        "last_90d",
        "last_week_mon_sun",
        "last_week_sun_sat",
        "last_quarter",
        "last_year",
        "this_week_mon_today",
        "this_week_sun_today",
        "this_year"
      ]
    },
    "time_range": {
      "type": "object",
      "description": "Custom date range for insights.",
      "properties": {
        "since": {
          "type": "string",
          "description": "Start date in YYYY-MM-DD format."
        },
        "until": {
          "type": "string",
          "description": "End date in YYYY-MM-DD format."
        }
      }
    },
    "time_increment": {
      "type": "string",
      "description": "How to break down results by time: 1 for daily, 7 for weekly, monthly, or all_days."
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated metrics to return (e.g. impressions,clicks,spend,cpc,cpm,ctr,reach,frequency). Pass as comma-separated string."
    },
    "level": {
      "type": "string",
      "description": "Level of aggregation for results.",
      "enum": [
        "account",
        "campaign",
        "adset",
        "ad"
      ]
    },
    "breakdowns": {
      "type": "string",
      "description": "How to break down results (e.g. age,gender,country,placement). Pass as comma-separated string."
    },
    "filtering": {
      "type": "string",
      "description": "Filters for the report as JSON array, e.g. [{\"field\":\"campaign.id\",\"operator\":\"IN\",\"value\":[\"123\"]}]."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return."
    }
  },
  "required": [
    "PCID",
    "ad_account_id",
    "fields"
  ]
}

---

meta_ads_manager_get_ad

Get ad

Parameters:

Parameter	Type	Required	Default	Description
ad_id	string	Yes	—	ID of the ad.
date_preset	string	No	—	Predefined date range used to aggregate insights metrics.
time_range	object	No	—	Date range used to aggregate insights metrics.
fields	string	No	—	Comma-separated list of fields to return. Pass as comma-separated string.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_id": {
      "type": "string",
      "description": "ID of the ad."
    },
    "date_preset": {
      "type": "string",
      "description": "Predefined date range used to aggregate insights metrics.",
      "enum": [
        "today",
        "yesterday",
        "this_month",
        "last_month",
        "this_quarter",
        "maximum",
        "last_3d",
        "last_7d",
        "last_14d",
        "last_28d",
        "last_30d",
        "last_90d",
        "last_week_mon_sun",
        "last_week_sun_sat",
        "last_quarter",
        "last_year",
        "this_week_mon_today",
        "this_week_sun_today",
        "this_year"
      ]
    },
    "time_range": {
      "type": "object",
      "description": "Date range used to aggregate insights metrics.",
      "properties": {
        "since": {
          "type": "string",
          "description": "Start date in YYYY-MM-DD format."
        },
        "until": {
          "type": "string",
          "description": "End date in YYYY-MM-DD format."
        }
      }
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return. Pass as comma-separated string."
    }
  },
  "required": [
    "PCID",
    "ad_id"
  ]
}

---

meta_ads_manager_get_ad_set

Get ad set

Parameters:

Parameter	Type	Required	Default	Description
ad_set_id	string	Yes	—	ID of the ad set.
date_preset	string	No	—	Predefined date range used to aggregate insights metrics.
time_range	object	No	—	Time range for insights aggregation.
fields	string	No	—	Comma-separated list of fields to return. Pass as comma-separated string.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_set_id": {
      "type": "string",
      "description": "ID of the ad set."
    },
    "date_preset": {
      "type": "string",
      "description": "Predefined date range used to aggregate insights metrics.",
      "enum": [
        "today",
        "yesterday",
        "this_month",
        "last_month",
        "this_quarter",
        "maximum",
        "last_3d",
        "last_7d",
        "last_14d",
        "last_28d",
        "last_30d",
        "last_90d",
        "last_week_mon_sun",
        "last_week_sun_sat",
        "last_quarter",
        "last_year",
        "this_week_mon_today",
        "this_week_sun_today",
        "this_year"
      ]
    },
    "time_range": {
      "type": "object",
      "description": "Time range for insights aggregation.",
      "properties": {
        "since": {
          "type": "string",
          "description": "Start date in YYYY-MM-DD format."
        },
        "until": {
          "type": "string",
          "description": "End date in YYYY-MM-DD format."
        }
      }
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return. Pass as comma-separated string."
    }
  },
  "required": [
    "PCID",
    "ad_set_id"
  ]
}

---

meta_ads_manager_get_campaign

Get campaign

Parameters:

Parameter	Type	Required	Default	Description
campaign_id	string	Yes	—	ID of the campaign.
fields	string	No	—	Comma-separated list of fields to return. Pass as comma-separated string.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "campaign_id": {
      "type": "string",
      "description": "ID of the campaign."
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return. Pass as comma-separated string."
    }
  },
  "required": [
    "PCID",
    "campaign_id"
  ]
}

---

meta_ads_manager_get_campaign_insights

Get campaign insights

Parameters:

Parameter	Type	Required	Default	Description
campaign_id	string	Yes	—	ID of the campaign.
date_preset	string	No	—	Predefined date range for insights.
time_range	object	No	—	Custom date range for insights.
time_increment	string	No	—	How to break down results by time.
fields	string	Yes	—	Comma-separated metrics to return. Pass as comma-separated string.
breakdowns	string	No	—	How to break down results. Pass as comma-separated string.
limit	integer	No	—	Maximum number of results to return.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "campaign_id": {
      "type": "string",
      "description": "ID of the campaign."
    },
    "date_preset": {
      "type": "string",
      "description": "Predefined date range for insights.",
      "enum": [
        "today",
        "yesterday",
        "this_month",
        "last_month",
        "this_quarter",
        "maximum",
        "last_3d",
        "last_7d",
        "last_14d",
        "last_28d",
        "last_30d",
        "last_90d",
        "last_week_mon_sun",
        "last_week_sun_sat",
        "last_quarter",
        "last_year",
        "this_week_mon_today",
        "this_week_sun_today",
        "this_year"
      ]
    },
    "time_range": {
      "type": "object",
      "description": "Custom date range for insights.",
      "properties": {
        "since": {
          "type": "string",
          "description": "Start date in YYYY-MM-DD format."
        },
        "until": {
          "type": "string",
          "description": "End date in YYYY-MM-DD format."
        }
      }
    },
    "time_increment": {
      "type": "string",
      "description": "How to break down results by time."
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated metrics to return. Pass as comma-separated string."
    },
    "breakdowns": {
      "type": "string",
      "description": "How to break down results. Pass as comma-separated string."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return."
    }
  },
  "required": [
    "PCID",
    "campaign_id",
    "fields"
  ]
}

---

meta_ads_manager_list_ad_sets

List ad sets

Parameters:

Parameter	Type	Required	Default	Description
ad_account_id	string	Yes	—	ID of the ad account.
date_preset	string	No	—	Predefined date range used to aggregate insights metrics.
effective_status	string	No	—	Filter ad sets by effective status. Pass as JSON array string, e.g. [“ACTIVE”]. Valid values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES.
is_completed	boolean	No	—	If true, return completed ad sets.
time_range	object	No	—	Time range for insights aggregation.
updated_since	integer	No	—	Time since the ad set has been updated.
fields	string	No	—	Comma-separated list of fields to return. Pass as comma-separated string.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_account_id": {
      "type": "string",
      "description": "ID of the ad account."
    },
    "date_preset": {
      "type": "string",
      "description": "Predefined date range used to aggregate insights metrics.",
      "enum": [
        "today",
        "yesterday",
        "this_month",
        "last_month",
        "this_quarter",
        "maximum",
        "last_3d",
        "last_7d",
        "last_14d",
        "last_28d",
        "last_30d",
        "last_90d",
        "last_week_mon_sun",
        "last_week_sun_sat",
        "last_quarter",
        "last_year",
        "this_week_mon_today",
        "this_week_sun_today",
        "this_year"
      ]
    },
    "effective_status": {
      "type": "string",
      "description": "Filter ad sets by effective status. Pass as JSON array string, e.g. [\"ACTIVE\"]. Valid values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES."
    },
    "is_completed": {
      "type": "boolean",
      "description": "If true, return completed ad sets."
    },
    "time_range": {
      "type": "object",
      "description": "Time range for insights aggregation.",
      "properties": {
        "since": {
          "type": "string",
          "description": "Start date in YYYY-MM-DD format."
        },
        "until": {
          "type": "string",
          "description": "End date in YYYY-MM-DD format."
        }
      }
    },
    "updated_since": {
      "type": "integer",
      "description": "Time since the ad set has been updated."
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return. Pass as comma-separated string."
    }
  },
  "required": [
    "PCID",
    "ad_account_id"
  ]
}

---

meta_ads_manager_list_ads

List ads

Parameters:

Parameter	Type	Required	Default	Description
ad_account_id	string	Yes	—	ID of the ad account.
date_preset	string	No	—	Predefined date range used to aggregate insights metrics.
effective_status	string	No	—	Filter ads by effective status. Pass as JSON array string, e.g. [“ACTIVE”]. Valid values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES.
time_range	object	No	—	Date range used to aggregate insights metrics.
updated_since	integer	No	—	Filter to ads updated since this Unix timestamp.
fields	string	No	—	Comma-separated list of fields to return. Pass as comma-separated string.
summary	string	No	—	Aggregated information about the edge, such as counts. Pass as JSON array string, e.g. [“insights”]. Valid values: insights, total_count.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_account_id": {
      "type": "string",
      "description": "ID of the ad account."
    },
    "date_preset": {
      "type": "string",
      "description": "Predefined date range used to aggregate insights metrics.",
      "enum": [
        "today",
        "yesterday",
        "this_month",
        "last_month",
        "this_quarter",
        "maximum",
        "last_3d",
        "last_7d",
        "last_14d",
        "last_28d",
        "last_30d",
        "last_90d",
        "last_week_mon_sun",
        "last_week_sun_sat",
        "last_quarter",
        "last_year",
        "this_week_mon_today",
        "this_week_sun_today",
        "this_year"
      ]
    },
    "effective_status": {
      "type": "string",
      "description": "Filter ads by effective status. Pass as JSON array string, e.g. [\"ACTIVE\"]. Valid values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES."
    },
    "time_range": {
      "type": "object",
      "description": "Date range used to aggregate insights metrics.",
      "properties": {
        "since": {
          "type": "string",
          "description": "Start date in YYYY-MM-DD format."
        },
        "until": {
          "type": "string",
          "description": "End date in YYYY-MM-DD format."
        }
      }
    },
    "updated_since": {
      "type": "integer",
      "description": "Filter to ads updated since this Unix timestamp."
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return. Pass as comma-separated string."
    },
    "summary": {
      "type": "string",
      "description": "Aggregated information about the edge, such as counts. Pass as JSON array string, e.g. [\"insights\"]. Valid values: insights, total_count."
    }
  },
  "required": [
    "PCID",
    "ad_account_id"
  ]
}

---

meta_ads_manager_list_campaigns

List campaigns

Parameters:

Parameter	Type	Required	Default	Description
ad_account_id	string	Yes	—	ID of the ad account.
date_preset	string	No	—	Predefined date range used to aggregate insights metrics.
effective_status	string	No	—	Filter campaigns by effective status. Pass as JSON array string, e.g. [“ACTIVE”]. Valid values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES.
is_completed	boolean	No	—	If true, return completed campaigns.
time_range	object	No	—	Date range used to aggregate insights metrics.
fields	string	No	—	Comma-separated list of fields to return (e.g. name,id,status,objective,daily_budget,lifetime_budget). Pass as comma-separated string.
summary	string	No	—	Aggregated information about the edge, such as counts. Pass as JSON array string, e.g. [“insights”]. Valid values: insights, total_count.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_account_id": {
      "type": "string",
      "description": "ID of the ad account."
    },
    "date_preset": {
      "type": "string",
      "description": "Predefined date range used to aggregate insights metrics.",
      "enum": [
        "today",
        "yesterday",
        "this_month",
        "last_month",
        "this_quarter",
        "maximum",
        "last_3d",
        "last_7d",
        "last_14d",
        "last_28d",
        "last_30d",
        "last_90d",
        "last_week_mon_sun",
        "last_week_sun_sat",
        "last_quarter",
        "last_year",
        "this_week_mon_today",
        "this_week_sun_today",
        "this_year"
      ]
    },
    "effective_status": {
      "type": "string",
      "description": "Filter campaigns by effective status. Pass as JSON array string, e.g. [\"ACTIVE\"]. Valid values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES."
    },
    "is_completed": {
      "type": "boolean",
      "description": "If true, return completed campaigns."
    },
    "time_range": {
      "type": "object",
      "description": "Date range used to aggregate insights metrics.",
      "properties": {
        "since": {
          "type": "string",
          "description": "Start date in YYYY-MM-DD format."
        },
        "until": {
          "type": "string",
          "description": "End date in YYYY-MM-DD format."
        }
      }
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return (e.g. name,id,status,objective,daily_budget,lifetime_budget). Pass as comma-separated string."
    },
    "summary": {
      "type": "string",
      "description": "Aggregated information about the edge, such as counts. Pass as JSON array string, e.g. [\"insights\"]. Valid values: insights, total_count."
    }
  },
  "required": [
    "PCID",
    "ad_account_id"
  ]
}

---

meta_ads_manager_update_ad

Update ad

Parameters:

Parameter	Type	Required	Default	Description
ad_id	string	Yes	—	ID of the ad.
name	string	No	—	Name of the ad.
status	string	No	—	Ad status.
bid_amount	integer	No	—	Bid amount in account currency subunits.
creative	string	No	—	Ad creative spec as JSON string.
tracking_specs	string	No	—	Tracking specs as JSON string.
conversion_domain	string	No	—	Domain where conversions happen.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_id": {
      "type": "string",
      "description": "ID of the ad."
    },
    "name": {
      "type": "string",
      "description": "Name of the ad."
    },
    "status": {
      "type": "string",
      "description": "Ad status.",
      "enum": [
        "ACTIVE",
        "PAUSED",
        "DELETED",
        "ARCHIVED"
      ]
    },
    "bid_amount": {
      "type": "integer",
      "description": "Bid amount in account currency subunits."
    },
    "creative": {
      "type": "string",
      "description": "Ad creative spec as JSON string."
    },
    "tracking_specs": {
      "type": "string",
      "description": "Tracking specs as JSON string."
    },
    "conversion_domain": {
      "type": "string",
      "description": "Domain where conversions happen."
    }
  },
  "required": [
    "PCID",
    "ad_id"
  ]
}

---

meta_ads_manager_update_ad_set

Update ad set

Parameters:

Parameter	Type	Required	Default	Description
ad_set_id	string	Yes	—	ID of the ad set.
name	string	No	—	Ad set name.
status	string	No	—	Ad set status.
daily_budget	integer	No	—	Daily budget in account currency subunits.
lifetime_budget	integer	No	—	Lifetime budget in account currency subunits.
bid_amount	integer	No	—	Bid cap or target cost in account currency subunits.
bid_strategy	string	No	—	Bid strategy for this ad set.
end_time	string	No	—	End time (ISO 8601 format).
targeting	string	No	—	Targeting spec as JSON string.
optimization_goal	string	No	—	What the ad set is optimizing for.
pacing_type	string	No	—	Defines the pacing type. Pass as JSON array string (for example, [“standard”]).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ad_set_id": {
      "type": "string",
      "description": "ID of the ad set."
    },
    "name": {
      "type": "string",
      "description": "Ad set name."
    },
    "status": {
      "type": "string",
      "description": "Ad set status.",
      "enum": [
        "ACTIVE",
        "PAUSED",
        "DELETED",
        "ARCHIVED"
      ]
    },
    "daily_budget": {
      "type": "integer",
      "description": "Daily budget in account currency subunits."
    },
    "lifetime_budget": {
      "type": "integer",
      "description": "Lifetime budget in account currency subunits."
    },
    "bid_amount": {
      "type": "integer",
      "description": "Bid cap or target cost in account currency subunits."
    },
    "bid_strategy": {
      "type": "string",
      "description": "Bid strategy for this ad set.",
      "enum": [
        "LOWEST_COST_WITHOUT_CAP",
        "LOWEST_COST_WITH_BID_CAP",
        "COST_CAP"
      ]
    },
    "end_time": {
      "type": "string",
      "description": "End time (ISO 8601 format)."
    },
    "targeting": {
      "type": "string",
      "description": "Targeting spec as JSON string."
    },
    "optimization_goal": {
      "type": "string",
      "description": "What the ad set is optimizing for.",
      "enum": [
        "NONE",
        "APP_INSTALLS",
        "AD_RECALL_LIFT",
        "ENGAGED_USERS",
        "EVENT_RESPONSES",
        "IMPRESSIONS",
        "LEAD_GENERATION",
        "QUALITY_LEAD",
        "LINK_CLICKS",
        "OFFSITE_CONVERSIONS",
        "PAGE_LIKES",
        "POST_ENGAGEMENT",
        "QUALITY_CALL",
        "REACH",
        "LANDING_PAGE_VIEWS",
        "VISIT_INSTAGRAM_PROFILE",
        "VALUE",
        "THRUPLAY",
        "DERIVED_EVENTS",
        "APP_INSTALLS_AND_OFFSITE_CONVERSIONS",
        "CONVERSATIONS"
      ]
    },
    "pacing_type": {
      "type": "string",
      "description": "Defines the pacing type. Pass as JSON array string (for example, [\"standard\"])."
    }
  },
  "required": [
    "PCID",
    "ad_set_id"
  ]
}

---

meta_ads_manager_update_campaign

Update campaign

Parameters:

Parameter	Type	Required	Default	Description
campaign_id	string	Yes	—	ID of the campaign.
name	string	No	—	Name for this campaign.
status	string	No	—	Campaign status.
daily_budget	integer	No	—	Daily budget in account currency subunits.
lifetime_budget	integer	No	—	Lifetime budget in account currency subunits.
bid_strategy	string	No	—	Bid strategy for this campaign.
spend_cap	integer	No	—	Spend cap in account currency subunits.
start_time	string	No	—	Campaign start time.
stop_time	string	No	—	Campaign stop time.
special_ad_categories	string	No	—	Special ad categories. Pass as JSON array string, e.g. [“NONE”]. Valid values: NONE, EMPLOYMENT, HOUSING, CREDIT, ISSUES_ELECTIONS_POLITICS, ONLINE_GAMBLING_AND_GAMING.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "campaign_id": {
      "type": "string",
      "description": "ID of the campaign."
    },
    "name": {
      "type": "string",
      "description": "Name for this campaign."
    },
    "status": {
      "type": "string",
      "description": "Campaign status.",
      "enum": [
        "ACTIVE",
        "PAUSED",
        "DELETED",
        "ARCHIVED"
      ]
    },
    "daily_budget": {
      "type": "integer",
      "description": "Daily budget in account currency subunits."
    },
    "lifetime_budget": {
      "type": "integer",
      "description": "Lifetime budget in account currency subunits."
    },
    "bid_strategy": {
      "type": "string",
      "description": "Bid strategy for this campaign.",
      "enum": [
        "LOWEST_COST_WITHOUT_CAP",
        "LOWEST_COST_WITH_BID_CAP",
        "COST_CAP"
      ]
    },
    "spend_cap": {
      "type": "integer",
      "description": "Spend cap in account currency subunits."
    },
    "start_time": {
      "type": "string",
      "description": "Campaign start time."
    },
    "stop_time": {
      "type": "string",
      "description": "Campaign stop time."
    },
    "special_ad_categories": {
      "type": "string",
      "description": "Special ad categories. Pass as JSON array string, e.g. [\"NONE\"]. Valid values: NONE, EMPLOYMENT, HOUSING, CREDIT, ISSUES_ELECTIONS_POLITICS, ONLINE_GAMBLING_AND_GAMING."
    }
  },
  "required": [
    "PCID",
    "campaign_id"
  ]
}