> ## Documentation Index > Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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`](#meta_ads_manager_create_ad) | Create ad | | [`meta_ads_manager_create_ad_set`](#meta_ads_manager_create_ad_set) | Create ad set | | [`meta_ads_manager_create_campaign`](#meta_ads_manager_create_campaign) | Create campaign | | [`meta_ads_manager_delete_ad`](#meta_ads_manager_delete_ad) | Delete ad | | [`meta_ads_manager_delete_ad_set`](#meta_ads_manager_delete_ad_set) | Delete ad set | | [`meta_ads_manager_delete_campaign`](#meta_ads_manager_delete_campaign) | Delete campaign | | [`meta_ads_manager_dissociate_campaigns`](#meta_ads_manager_dissociate_campaigns) | Dissociate campaigns | | [`meta_ads_manager_get_account_insights`](#meta_ads_manager_get_account_insights) | Get account insights | | [`meta_ads_manager_get_ad`](#meta_ads_manager_get_ad) | Get ad | | [`meta_ads_manager_get_ad_set`](#meta_ads_manager_get_ad_set) | Get ad set | | [`meta_ads_manager_get_campaign`](#meta_ads_manager_get_campaign) | Get campaign | | [`meta_ads_manager_get_campaign_insights`](#meta_ads_manager_get_campaign_insights) | Get campaign insights | | [`meta_ads_manager_list_ad_sets`](#meta_ads_manager_list_ad_sets) | List ad sets | | [`meta_ads_manager_list_ads`](#meta_ads_manager_list_ads) | List ads | | [`meta_ads_manager_list_campaigns`](#meta_ads_manager_list_campaigns) | List campaigns | | [`meta_ads_manager_update_ad`](#meta_ads_manager_update_ad) | Update ad | | [`meta_ads_manager_update_ad_set`](#meta_ads_manager_update_ad_set) | Update ad set | | [`meta_ads_manager_update_campaign`](#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":"\"} 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. | ```json theme={null} { "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\":\"\"} 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. | ```json theme={null} { "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). | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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. | ```json theme={null} { "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"]). | ```json theme={null} { "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. | ```json theme={null} { "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" ] } ```