Skip to content
Ads APIReferences / Ad Sets / Get Ad Set Links

Get Ad Set Links

Returns a list of available ad set links.

Request

POST
/adSetlinks
  • organization_ids
    array of strings
  • ad_account_ids
    array of strings
  • ad_set_link_ids
    array of strings
  • limit
    integer [int32]
    Example: 2
  • offset
    integer [int32]
    Example: 0

Response

    • id
      string [uuid]
    • ad_set_id
      string [uuid]
      • id
        string [uuid]
        Required
      • version
        integer [int64]
        Required
        Example: 1
    • status
      string [ad-set-link-approval-status]
      Allowed values: "ACTIVE", "APPROVED", "PENDING_APPROVAL", "REJECTED", "REQUIRES_REAPPROVAL", "ARCHIVED"Example: "ACTIVE"
    • active_status
      string [ad-set-link-active-status]
      Allowed values: "ACTIVE", "PAUSED"Example: "ACTIVE"
    • reject_reason
      string
      Example: "Reject reason"
    • version
      integer [int64]
      Example: 1
  • total_ad_set_links
    integer [int64]

Response sample

{  "ad_set_links": [    {      "id": "mk66a2eb-35cf-46a4-8d2e-0j95dfc133l9",      "ad_set_id": "mk66a2eb-35cf-46a4-8d2e-0j95dfc133l9",      "ad": {        "id": "mk66a2eb-35cf-46a4-8d2e-0j95dfc133l9",        "version": 1      },      "status": "ACTIVE",      "active_status": "ACTIVE",      "reject_reason": "Reject reason",      "version": 1    }  ],  "total_ad_set_links": 2}