Create a campaign

A campaign is the highest level organizational structure within an ad account and should represent a single objective for an advertiser, for example, to drive page post engagement. Setting the objective of the campaign enforces validation on any ads added to that campaign to ensure they also have the correct objective.

In the ads manager, we show all of the active and paused campaigns within an ad account.

To read the campaigns associated with a specific account, you make a request to the connection of the ad account you are using. By default we only return campaigns whose status is ACTIVE or PAUSED, so you need to specify additional statuses if required:

Requirement

Value for parameter `objective`	Description
APP_INSTALLS	For app install ads, you can tell Facebook to optimize ads either for app installs or link clicks. When you choose app installs, Facebook will show your ads to people who are likely to install the app you're advertising. If you choose link clicks, people who are likely to click will be shown your ad.
BRAND_AWARENESS	The brand awareness objective is for advertisers who want to show ads to people who are more likely to recall them.
CONVERSIONS	The conversions objective is designed to drive valuable actions on your website, in your app or in Messenger from Meta. Actions can include landing page views, purchases, phone calls, messages and more. It requires the Meta Pixel or Conversions API for websites, or App Events for apps.
EVENT_RESPONSES	The number of people who responded Interested or Going to your Facebook event, attributed to your ads.
LEAD_GENERATION	The lead generation objective allows businesses to create campaigns to find potential customers for their products or services. Businesses can use these campaigns to gather information from new leads and help them move through the buying process.
LINK_CLICKS	The number of clicks on links within the ad that led to advertiser-specified destinations, on or off Meta technologies.
LOCAL_AWARENESS	Facebook local awareness ads serve ad content to users who are currently within a specified proximity from a brick-and-mortar store location.
MESSAGES	The Messages objective drives conversations to your business.
OFFER_CLAIMS	Facebook offer claims are the number of positive responses in response to your Facebook offer ad.
PAGE_LIKES	The number of likes of your Facebook Page, attributed to your ads.
POST_ENGAGEMENT	Post engagements are the total number of actions that people take involving your ads on Facebook.
PRODUCT_CATALOG_SALES	the catalog is a file that is filled with all the products you want to advertise, where Facebook can pick the best option for each specific consumer based on their interests and behavior.
REACH	The number of people who saw your ads at least once. Reach is different from impressions, which may include multiple views of your ads by the same people.
STORE_VISITS	The estimated number of visits to your stores, attributed to your ads. This metric only counts store visits for countries where you're eligible for measurement.
VIDEO_VIEWS	The Video Views objective optimizes to get the most plays of your video ad. Show your ads to the people who are most likely to watch for at least 2 continuous seconds, or 15 seconds or longer.

Value for parameter `special_ad_categories`	Description
[]

Value for parameter `status`	Description
PAUSED
ACTIVE

POST https://us-central1-appgregator.cloudfunctions.net/facebook/campaign/

Query Parameters

Name	Type	Description
name*	String	ft-4
connection_name*	String	fbads-01
adaccount_id*	String	act_1514519918873559

Headers

Name	Type	Description
x-api-key*	String	U2Fsd...

201: Created Created

{
    "id": "23852148573750549"
}

Body JSON

{
    "name": "Campaign-5",
    "objective": "POST_ENGAGEMENT",
    "status": "PAUSED",
    "special_ad_categories": "[]"
}

cURL

curl --location --request POST 'https://us-central1-appgregator.cloudfunctions.net/facebook/campaign?name=ft-4&connection_name=fbads-01&adaccount_id=act_1514519918873559' \
--header 'x-api-key: U2Fsd...' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Campaign-5",
    "objective": "POST_ENGAGEMENT",
    "status": "PAUSED",
    "special_ad_categories": "[]"
}'

NodeJS - Axios

var axios = require('axios');
var data = JSON.stringify({
  "name": "Campaign-5",
  "objective": "POST_ENGAGEMENT",
  "status": "PAUSED",
  "special_ad_categories": "[]"
});

var config = {
  method: 'post',
  url: 'https://us-central1-appgregator.cloudfunctions.net/facebook/campaign?name=ft-4&connection_name=fbads-01&adaccount_id=act_1514519918873559',
  headers: { 
    'x-api-key': 'U2Fsd...', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

PHP - cURL

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://us-central1-appgregator.cloudfunctions.net/facebook/campaign?name=ft-4&connection_name=fbads-01&adaccount_id=act_1514519918873559',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "name": "Campaign-5",
    "objective": "POST_ENGAGEMENT",
    "status": "PAUSED",
    "special_ad_categories": "[]"
}',
  CURLOPT_HTTPHEADER => array(
    'x-api-key: U2Fsd...',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;