Meta · Schema

Meta Marketing API Ad Campaign

Represents an advertising campaign in the Meta Marketing API (Campaign level in the Campaign > Ad Set > Ad hierarchy). Includes budget, objective, status, and scheduling fields.

AdvertisingAnalyticsArtificial IntelligenceMessagingSocialSocial MediaVirtual Reality

Properties

Name Type Description
id string The unique identifier for the campaign.
name string The name of the campaign.
account_id string The ID of the ad account that owns the campaign.
objective string The campaign objective defining the optimization goal. Uses the Outcome-Based Ads objectives introduced in Meta Marketing API v18+.
status string The campaign status set by the advertiser.
effective_status string The effective status of the campaign, accounting for parent ad account status and any issues.
configured_status string The configured status of the campaign as set in the API.
buying_type string The buying type for the campaign. AUCTION is the default for most campaigns.
bid_strategy string The bid strategy for the campaign.
budget_remaining string The remaining budget of the campaign in the account currency, expressed in cents.
daily_budget string The daily budget of the campaign in the account currency, expressed in cents.
lifetime_budget string The lifetime budget of the campaign in the account currency, expressed in cents.
spend_cap string The spend cap for the campaign in the account currency, expressed in cents.
special_ad_categories array Special ad categories the campaign falls under (e.g. credit, employment, housing, social issues).
start_time string The start time of the campaign, in ISO 8601 format.
stop_time string The stop/end time of the campaign, in ISO 8601 format.
created_time string The time the campaign was created, in ISO 8601 format.
updated_time string The time the campaign was last updated, in ISO 8601 format.
source_campaign_id string The ID of the source campaign this was copied from, if applicable.
smart_promotion_type string The type of smart promotion applied to the campaign.
pacing_type array The pacing type for ad delivery.
promoted_object object The object being promoted (e.g. a pixel, app, or Page).
adsets object The ad sets within this campaign.
insights object Performance insights/metrics for the campaign.
View JSON Schema on GitHub

JSON Schema

ad-campaign.json Raw ↑ 
{
  "$id": "https://meta.com/schemas/marketing-api/ad-campaign.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Meta Marketing API Ad Campaign",
  "description": "Represents an advertising campaign in the Meta Marketing API (Campaign level in the Campaign > Ad Set > Ad hierarchy). Includes budget, objective, status, and scheduling fields.",
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier for the campaign."
    },
    "name": {
      "type": "string",
      "description": "The name of the campaign."
    },
    "account_id": {
      "type": "string",
      "description": "The ID of the ad account that owns the campaign."
    },
    "objective": {
      "type": "string",
      "enum": [
        "OUTCOME_AWARENESS",
        "OUTCOME_ENGAGEMENT",
        "OUTCOME_LEADS",
        "OUTCOME_SALES",
        "OUTCOME_TRAFFIC",
        "OUTCOME_APP_PROMOTION"
      ],
      "description": "The campaign objective defining the optimization goal. Uses the Outcome-Based Ads objectives introduced in Meta Marketing API v18+."
    },
    "status": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "PAUSED",
        "DELETED",
        "ARCHIVED"
      ],
      "description": "The campaign status set by the advertiser."
    },
    "effective_status": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "PAUSED",
        "DELETED",
        "ARCHIVED",
        "IN_PROCESS",
        "WITH_ISSUES",
        "CAMPAIGN_PAUSED"
      ],
      "description": "The effective status of the campaign, accounting for parent ad account status and any issues."
    },
    "configured_status": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "PAUSED",
        "DELETED",
        "ARCHIVED"
      ],
      "description": "The configured status of the campaign as set in the API."
    },
    "buying_type": {
      "type": "string",
      "enum": [
        "AUCTION",
        "RESERVED"
      ],
      "description": "The buying type for the campaign. AUCTION is the default for most campaigns."
    },
    "bid_strategy": {
      "type": "string",
      "enum": [
        "LOWEST_COST_WITHOUT_CAP",
        "LOWEST_COST_WITH_BID_CAP",
        "COST_CAP",
        "LOWEST_COST_WITH_MIN_ROAS"
      ],
      "description": "The bid strategy for the campaign."
    },
    "budget_remaining": {
      "type": "string",
      "description": "The remaining budget of the campaign in the account currency, expressed in cents."
    },
    "daily_budget": {
      "type": "string",
      "description": "The daily budget of the campaign in the account currency, expressed in cents."
    },
    "lifetime_budget": {
      "type": "string",
      "description": "The lifetime budget of the campaign in the account currency, expressed in cents."
    },
    "spend_cap": {
      "type": "string",
      "description": "The spend cap for the campaign in the account currency, expressed in cents."
    },
    "special_ad_categories": {
      "type": "array",
      "description": "Special ad categories the campaign falls under (e.g. credit, employment, housing, social issues).",
      "items": {
        "type": "string",
        "enum": [
          "NONE",
          "EMPLOYMENT",
          "HOUSING",
          "CREDIT",
          "ISSUES_ELECTIONS_POLITICS"
        ]
      }
    },
    "start_time": {
      "type": "string",
      "format": "date-time",
      "description": "The start time of the campaign, in ISO 8601 format."
    },
    "stop_time": {
      "type": "string",
      "format": "date-time",
      "description": "The stop/end time of the campaign, in ISO 8601 format."
    },
    "created_time": {
      "type": "string",
      "format": "date-time",
      "description": "The time the campaign was created, in ISO 8601 format."
    },
    "updated_time": {
      "type": "string",
      "format": "date-time",
      "description": "The time the campaign was last updated, in ISO 8601 format."
    },
    "source_campaign_id": {
      "type": "string",
      "description": "The ID of the source campaign this was copied from, if applicable."
    },
    "smart_promotion_type": {
      "type": "string",
      "description": "The type of smart promotion applied to the campaign."
    },
    "pacing_type": {
      "type": "array",
      "description": "The pacing type for ad delivery.",
      "items": {
        "type": "string",
        "enum": [
          "standard",
          "no_pacing",
          "day_parting"
        ]
      }
    },
    "promoted_object": {
      "type": "object",
      "description": "The object being promoted (e.g. a pixel, app, or Page).",
      "properties": {
        "pixel_id": {
          "type": "string",
          "description": "The Meta Pixel ID."
        },
        "application_id": {
          "type": "string",
          "description": "The application (app) ID."
        },
        "page_id": {
          "type": "string",
          "description": "The Facebook Page ID."
        },
        "custom_event_type": {
          "type": "string",
          "description": "The custom conversion event type (e.g. PURCHASE, LEAD, ADD_TO_CART)."
        }
      }
    },
    "adsets": {
      "type": "object",
      "description": "The ad sets within this campaign.",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "insights": {
      "type": "object",
      "description": "Performance insights/metrics for the campaign.",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "impressions": {
                "type": "string"
              },
              "clicks": {
                "type": "string"
              },
              "spend": {
                "type": "string"
              },
              "reach": {
                "type": "string"
              },
              "cpc": {
                "type": "string"
              },
              "cpm": {
                "type": "string"
              },
              "ctr": {
                "type": "string"
              },
              "date_start": {
                "type": "string",
                "format": "date"
              },
              "date_stop": {
                "type": "string",
                "format": "date"
              }
            }
          }
        }
      }
    }
  },
  "additionalProperties": true,
  "examples": [
    {
      "id": "23851234567890123",
      "name": "Summer Sale 2025 - Awareness",
      "account_id": "act_123456789",
      "objective": "OUTCOME_AWARENESS",
      "status": "ACTIVE",
      "effective_status": "ACTIVE",
      "buying_type": "AUCTION",
      "bid_strategy": "LOWEST_COST_WITHOUT_CAP",
      "daily_budget": "5000",
      "special_ad_categories": [
        "NONE"
      ],
      "start_time": "2025-06-01T00:00:00-0700",
      "created_time": "2025-05-28T10:15:00-0700",
      "promoted_object": {
        "page_id": "123456789012345"
      }
    }
  ]
}