List all promoteds

GET/ads/{connection_id}/promoted

Parameters

limitnumber default=100
offsetnumber default=0
updated_gtedate
Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
sort enum
order enum
querystring
Query string to search. eg. email address or name
org_idstring
The org ID to filter by (reference to AdsOrganization)
type enum
fieldsstring array
Fields to return
rawstring
Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar
connection_idstring required
ID of the connection

Returns

Promoted entity (e.g. page, app, product, tweet) for ads create

idstring required
namestring
type enum required
Valid values:
"PAGE_ID"
"APP_ID"
"STORE_URL"
"PIXEL_ID"
"CUSTOM_CONVERSION_ID"
Promoted entity types for ads_promoted list endpoint
const options = {
  method: 'GET',
  url: 'https://api.unified.to/ads/5de520f96e439b002043d8dc/promoted',
  headers: {
    authorization: 'bearer .....'
  },
  params: {
    limit: 50,
    offset: 0,
    updated_gte: '2026-06-12T19:00:36.351Z',
    sort: 'updated_at',
    order: 'asc',
    query: '',
    org_id: '',
    type: '',
    fields: '',
    raw: '',
  }
};

const results = await axios.request(options);
Are we missing anything? Let us know
Was this page helpful?