List all groups
GET/ads/{connection_id}/group
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)
campaign_idstring
The campaign ID to filter by
parent_idstring
The parent ID to filter by
io_idstring
The IO ID to filter by
start_gtestring
The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
end_ltstring
The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
statusstring
The status to filter by
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
AdsGrouparray
idstring
created_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
updated_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
namestring
parent_idstring
campaign_idstring
organization_idstring
insertionorder_idstring
bid_amountnumber
budget_amountnumber
budget_period enum
Valid values:
"DAILY"
"MONTHLY"
"TOTAL"
"LIFETIME"
budget_allocation_type enum
Valid values:
"UNSPECIFIED"
"AUTOMATIC"
"FIXED"
"UNLIMITED"
start_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
end_atdate
(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
budget_unit enum
Valid values:
"UNSPECIFIED"
"CURRENCY"
"IMPRESSIONS"
budget_max_amountnumber
has_eu_political_adsboolean
creative_idsstring array
optimization_goal enum
Optimization goals for ads_group (cross-platform; platform-specific values allowed as pass-through)
billing_event enum
Billing events for ads_group (what you pay for; cross-platform; platform-specific values allowed as pass-through)
currencystring
const options = {
method: 'GET',
url: 'https://api.unified.to/ads/5de520f96e439b002043d8dc/group',
headers: {
authorization: 'bearer .....'
},
params: {
limit: 50,
offset: 0,
updated_gte: '2026-06-30T19:51:01.337Z',
sort: 'updated_at',
order: 'asc',
query: '',
org_id: '',
campaign_id: '',
parent_id: '',
io_id: '',
start_gte: '',
end_lt: '',
status: '',
fields: '',
raw: '',
}
};
const results = await axios.request(options); Are we missing anything? Let us know