meta-ads-manager

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.

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"
      ]
    }
  },
  "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."
    },
    "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."
    },
    "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."
    },
    "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."
    },
    "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.
`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_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"
      ]
    },
    "time_range": {
      "type": "object",
      "description": "Time range for insights aggregation."
    },
    "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."
    },
    "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."
    },
    "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.

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"
      ]
    }
  },
  "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"
  ]
}

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Tools

meta_ads_manager_create_ad

meta_ads_manager_create_ad_set

meta_ads_manager_create_campaign

meta_ads_manager_delete_ad

meta_ads_manager_delete_ad_set

meta_ads_manager_delete_campaign

meta_ads_manager_dissociate_campaigns

meta_ads_manager_get_account_insights

meta_ads_manager_get_ad

meta_ads_manager_get_ad_set

meta_ads_manager_get_campaign

meta_ads_manager_get_campaign_insights

meta_ads_manager_list_ad_sets

meta_ads_manager_list_ads

meta_ads_manager_list_campaigns

meta_ads_manager_update_ad

meta_ads_manager_update_ad_set

meta_ads_manager_update_campaign

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

​Tools

​meta_ads_manager_create_ad

​meta_ads_manager_create_ad_set

​meta_ads_manager_create_campaign

​meta_ads_manager_delete_ad

​meta_ads_manager_delete_ad_set

​meta_ads_manager_delete_campaign

​meta_ads_manager_dissociate_campaigns

​meta_ads_manager_get_account_insights

​meta_ads_manager_get_ad

​meta_ads_manager_get_ad_set

​meta_ads_manager_get_campaign

​meta_ads_manager_get_campaign_insights

​meta_ads_manager_list_ad_sets

​meta_ads_manager_list_ads

​meta_ads_manager_list_campaigns

​meta_ads_manager_update_ad

​meta_ads_manager_update_ad_set

​meta_ads_manager_update_campaign

Tools

meta_ads_manager_create_ad

meta_ads_manager_create_ad_set

meta_ads_manager_create_campaign

meta_ads_manager_delete_ad

meta_ads_manager_delete_ad_set

meta_ads_manager_delete_campaign

meta_ads_manager_dissociate_campaigns

meta_ads_manager_get_account_insights

meta_ads_manager_get_ad

meta_ads_manager_get_ad_set

meta_ads_manager_get_campaign

meta_ads_manager_get_campaign_insights

meta_ads_manager_list_ad_sets

meta_ads_manager_list_ads

meta_ads_manager_list_campaigns

meta_ads_manager_update_ad

meta_ads_manager_update_ad_set

meta_ads_manager_update_campaign