Ads

An ad object contains all of the information necessary to display an ad on Facebook, including the creative.

GET https://us-central1-appgregator.cloudfunctions.net/facebook/adaccounts/ads/

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...

400: Bad Request Bad Request

{
    "error": {
        "message": "An unknown error has occurred.",
        "type": "OAuthException",
        "code": 1,
        "fbtrace_id": "AVb9Jih2dsqdc0TI3CZSZDN"
    }
}

201: Created Created

{
    "id": "23852150578290549"
}

Body JSON

{
    "name" : "My Ad",
    "adset_id" : "23852148656900549",
    "creative" : {
        "creative_id": "23852150404470549"
    },
    "status" : "PAUSED"
}

cURL

curl --location --request POST 'https://us-central1-appgregator.cloudfunctions.net/facebook/adaccounts/ads?name=ft-4&connection_name=fbads-01&adaccount_id=act_1514519918873559' \
--header 'x-api-key: U2Fsd...' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name" : "My Ad",
    "adset_id" : "23852148656900549",
    "creative" : {
        "creative_id": "23852150404470549"
    },
    "status" : "PAUSED"
}'

NodeJS - Axios

var axios = require('axios');
var data = JSON.stringify({
  "name": "My Ad",
  "adset_id": "23852148656900549",
  "creative": {
    "creative_id": "23852150404470549"
  },
  "status": "PAUSED"
});

var config = {
  method: 'post',
  url: 'https://us-central1-appgregator.cloudfunctions.net/facebook/adaccounts/ads?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/adaccounts/ads?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" : "My Ad",
    "adset_id" : "23852148656900549",
    "creative" : {
        "creative_id": "23852150404470549"
    },
    "status" : "PAUSED"
}',
  CURLOPT_HTTPHEADER => array(
    'x-api-key: U2Fsd...',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;