---
title: "Group data model"
url: "https://docs.unified.to/ads/group/model"
description: "API reference for Group data model. Launch multiple pre-built Group integrations today with zero maintenance — all through a single API."
generated_at: "2026-06-30T19:54:08.203Z"
---
# Group data model

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/ads/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

**created\_at**date 

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

**updated\_at**date 

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

**name**string 

**parent\_id**string 

**campaign\_id**string 

**organization\_id**string 

**insertionorder\_id**string 

**status** enum

Valid values:

 "UNSPECIFIED" 

 "ACTIVE" 

 "PAUSED" 

 "ARCHIVED" 

 "DRAFT" 

**targeting**object 

**bid\_amount**number 

**bid\_strategy**object 

YOUTUBE\_AND\_PARTNERS

**budget\_amount**number 

**budget\_period** enum

Valid values:

 "DAILY" 

 "MONTHLY" 

 "TOTAL" 

 "LIFETIME" 

**budget\_allocation\_type** enum

Valid values:

 "UNSPECIFIED" 

 "AUTOMATIC" 

 "FIXED" 

 "UNLIMITED" 

**start\_at**date 

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

**end\_at**date 

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

**budget\_unit** enum

Valid values:

 "UNSPECIFIED" 

 "CURRENCY" 

 "IMPRESSIONS" 

**budget\_max\_amount**number 

**type** enum

Valid values:

 "TEXT" 

 "IMAGE" 

 "VIDEO" 

 "RESPONSIVE" 

 "SHOPPING" 

**has\_eu\_political\_ads**boolean 

**pacing**object 

**frequency\_cap**object 

**creative\_ids**string array 

**optimization\_goal** enum

Valid values:

 "REACH" 

 "IMPRESSIONS" 

 "LINK\_CLICKS" 

 "LANDING\_PAGE\_VIEWS" 

 "CONVERSIONS" 

Optimization goals for ads\_group (cross-platform; platform-specific values allowed as pass-through)

**billing\_event** enum

Valid values:

 "IMPRESSIONS" 

 "LINK\_CLICKS" 

 "VIDEO\_VIEWS" 

 "APP\_INSTALLS" 

 "ENGAGEMENT" 

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

**currency**string 

**promoted** array 

**raw**any