Marketing API Version

AdSetAds

Provides operations to create, read, update and delete AdSetAds.

Read AdSetAds

Permissions

A user access token with Atlas API capability is required to request adsetad details.

Fields

Reading this endpoint returns a single or an array of AdSetAd objects with the same fields as the node.

Read Ad AdSetAd

You can get details of adsetads for an ad by making an HTTP GET request.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<AD_ID>/ad_set_ads

Response:

{
  "data": [
    {
      "ad_id": "11002200631400", 
      "ad_set_id": "11002200632600", 
      "created_date": "2014-09-19T21:38:37+0000", 
      "id": "11002200632800", 
      "last_modified_date": "2014-09-19T21:38:37+0000", 
      "sequence_number": "33000100",
      "version": "1",
      "weight": "1"
    }
  ]
}

Curl Example

A curl example to get ads for an adset:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<AD_ID>/ad_set_ads

Create AdSetAds

Permissions

A user access token with Atlas API capability is required to create or update adsetad details.

Fields

Publishing this endpoint returns a single or an array of AdSetAd objects.

Create AdSetAd

You can create adsetad by making an HTTP POST request. It will update the adsetad if it already exists.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>/ad_set_ads?ad_set_ads=[{ "ad_set_id": "11002200632600",  "ad_id": "11002200631400",   "sequence_number": "42490969",     "weight": "1" }]

Response:

{
  "data": [
    {
      "id": "11002200632800", 
      "success": true
    }
  ]
}

Curl Example

A curl example to create adsetads:

curl \
  -F 'ad_set_ads=[{ "ad_set_id": "11002200632600",  "ad_id": "11002200631400",   "sequence_number": "42490969",     "weight": "1" }]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>/atlasadsetads

Delete Atlas AdSetAds

Permissions

A user access token with Atlas API capability is required to delete adsetads.

Delete AdSetAd

You can delete adsetads by making an HTTP DELETE request.

An example of the request and response:

Request:

https://graph.facebook.com/<API_VERSION>/<AD_SET_AD_ID>

Response:

{
  "data": [
    {
      "ad_set_ad": {
        "id": "11002200632800", 
        "created_by": "1444052100", 
        "created_date": "2014-09-09T11:49:06-07:00", 
        "last_modified_by": "1444052100", 
        "last_modified_date": "2014-09-09T13:03:10-07:00", 
        "is_deleted": true, 
        "version": "2", 
        "ad_set_id": "11002200632600", 
        "ad_id": "11002200631400", 
        "sequence_number": "33000100", 
        "weight": "1"
      }
    }
  ]
}

Curl Example

A curl example to delete adsetads:

curl -XDELETE \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/<AD_SET_AD_ID>