ads
group

Create a group

post/ads/{connection_id}/group

Request

  • Base URL: http://api.unified.to
  • URL: http://api.unified.to/ads/{connection_id}/group
  • Auth: API key in header authorization

Path parameters

connection_idstring required

ID of the connection

Query parameters

fieldsstring[]

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

Request body

idstring
created_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

namestring
parent_idstring
campaign_idstring
organization_idstring
insertionorder_idstring
status'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
effective_status'UNSPECIFIED' | 'SERVING' | 'LIMITED' | 'LEARNING' | 'PAUSED' | 'PENDING' | 'ENDED' | 'MISCONFIGURED' | 'NOT_ELIGIBLE' | 'ARCHIVED' | 'REMOVED'
bid_amountnumber
budget_amountnumber
budget_period'DAILY' | 'MONTHLY' | 'TOTAL' | 'LIFETIME'
budget_allocation_type'UNSPECIFIED' | 'AUTOMATIC' | 'FIXED' | 'UNLIMITED'
start_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

end_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

budget_unit'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
budget_max_amountnumber
type'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH' | 'PERFORMANCE_MAX'
has_eu_political_adsboolean
creative_idsstring[]
optimization_goal'REACH' | 'IMPRESSIONS' | 'LINK_CLICKS' | 'LANDING_PAGE_VIEWS' | 'CONVERSIONS' | 'LEAD_GENERATION' | 'APP_INSTALLS' | 'APP_ENGAGEMENT' | 'VIDEO_VIEWS' | 'ENGAGEMENT' | 'PAGE_LIKES' | 'MESSAGES'

Optimization goals for ads_group (cross-platform; platform-specific values allowed as pass-through)

billing_event'IMPRESSIONS' | 'LINK_CLICKS' | 'VIDEO_VIEWS' | 'APP_INSTALLS' | 'ENGAGEMENT' | 'PAGE_LIKES' | 'MESSAGES' | 'POST_ENGAGEMENT' | 'PURCHASE' | 'NONE'

Billing events for ads_group (what you pay for; cross-platform; platform-specific values allowed as pass-through)

currencystring
language_localestring

Language + region, ISO 639-1 with region (e.g. en-US); LinkedIn locale

creative_selection'OPTIMIZED' | 'ROUND_ROBIN'

Creative rotation strategy (LinkedIn creativeSelection)

rawunknown

Response

Successful

idstring
created_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

namestring
parent_idstring
campaign_idstring
organization_idstring
insertionorder_idstring
status'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
effective_status'UNSPECIFIED' | 'SERVING' | 'LIMITED' | 'LEARNING' | 'PAUSED' | 'PENDING' | 'ENDED' | 'MISCONFIGURED' | 'NOT_ELIGIBLE' | 'ARCHIVED' | 'REMOVED'
bid_amountnumber
budget_amountnumber
budget_period'DAILY' | 'MONTHLY' | 'TOTAL' | 'LIFETIME'
budget_allocation_type'UNSPECIFIED' | 'AUTOMATIC' | 'FIXED' | 'UNLIMITED'
start_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

end_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

budget_unit'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
budget_max_amountnumber
type'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH' | 'PERFORMANCE_MAX'
has_eu_political_adsboolean
creative_idsstring[]
optimization_goal'REACH' | 'IMPRESSIONS' | 'LINK_CLICKS' | 'LANDING_PAGE_VIEWS' | 'CONVERSIONS' | 'LEAD_GENERATION' | 'APP_INSTALLS' | 'APP_ENGAGEMENT' | 'VIDEO_VIEWS' | 'ENGAGEMENT' | 'PAGE_LIKES' | 'MESSAGES'

Optimization goals for ads_group (cross-platform; platform-specific values allowed as pass-through)

billing_event'IMPRESSIONS' | 'LINK_CLICKS' | 'VIDEO_VIEWS' | 'APP_INSTALLS' | 'ENGAGEMENT' | 'PAGE_LIKES' | 'MESSAGES' | 'POST_ENGAGEMENT' | 'PURCHASE' | 'NONE'

Billing events for ads_group (what you pay for; cross-platform; platform-specific values allowed as pass-through)

currencystring
language_localestring

Language + region, ISO 639-1 with region (e.g. en-US); LinkedIn locale

creative_selection'OPTIMIZED' | 'ROUND_ROBIN'

Creative rotation strategy (LinkedIn creativeSelection)

rawunknown

Changes

No recorded changes to this operation across all 1 revision of this API.