---
title: "POST /v4/firstPartyAndPartnerAudiences"
method: POST
path: "/v4/firstPartyAndPartnerAudiences"
tags: ["firstPartyAndPartnerAudiences"]
---

# POST /v4/firstPartyAndPartnerAudiences

`POST /v4/firstPartyAndPartnerAudiences`

Creates a FirstPartyAndPartnerAudience. Only supported for the following audience_type: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`

## Query parameters

- `advertiserId` string

## Request body

- FirstPartyAndPartnerAudience — Describes a first or partner audience list used for targeting. First party audiences are created via usage of client data. Partner audiences are provided by Third Party data providers and can only be licensed to customers.
  - `activeDisplayAudienceSize` string, int64 — Output only. The estimated audience size for the Display network in the past month. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only returned in GET request.
  - `firstPartyAndPartnerAudienceId` string, int64 — Identifier. The unique ID of the first party and partner audience. Assigned by the system.
  - `gmailAudienceSize` string, int64 — Output only. The estimated audience size for Gmail network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.
  - `contactInfoList` ContactInfoList — Wrapper message for a list of contact information defining Customer Match audience members.
    - `contactInfos` ContactInfo[] — Optional. A list of ContactInfo objects defining Customer Match audience members. The size of members after splitting the contact_infos mustn't be greater than 500,000.
      - `hashedLastName` string — Optional. SHA256 hashed last name of the member. Before hashing, remove all whitespace and make sure the string is all lowercase. Must also be set with the following fields: * country_code * hashed_first_name * zip_codes
      - `hashedPhoneNumbers` string[] — Optional. A list of SHA256 hashed phone numbers of the member. Before hashing, all phone numbers must be formatted using the [E.164 format](https://en.wikipedia.org/wiki/E.164) and include the country calling code.
      - `hashedEmails` string[] — Optional. A list of SHA256 hashed email of the member. Before hashing, remove all whitespace and make sure the string is all lowercase.
      - `hashedFirstName` string — Optional. SHA256 hashed first name of the member. Before hashing, remove all whitespace and make sure the string is all lowercase. Must also be set with the following fields: * country_code * hashed_last_name * zip_codes
      - `zipCodes` string[] — Optional. A list of zip codes of the member. Must also be set with the following fields: * country_code * hashed_first_name * hashed_last_name
      - `countryCode` string — Optional. Country code of the member. Must also be set with the following fields: * country_code * hashed_first_name * hashed_last_name * zip_codes
    - `consent` Consent — User consent status.
      - `adPersonalization` 'CONSENT_STATUS_UNSPECIFIED' | 'CONSENT_STATUS_GRANTED' | 'CONSENT_STATUS_DENIED' — Represents consent for ad personalization.
      - `adUserData` 'CONSENT_STATUS_UNSPECIFIED' | 'CONSENT_STATUS_GRANTED' | 'CONSENT_STATUS_DENIED' — Represents consent for ad user data.
  - `appId` string — Optional. The app_id matches with the type of the mobile_device_ids being uploaded. Only applicable to audience_type `CUSTOMER_MATCH_DEVICE_ID`
  - `mobileDeviceIdList` MobileDeviceIdList — Wrapper message for a list of mobile device IDs defining Customer Match audience members.
    - `consent` Consent — User consent status.
      - `adPersonalization` 'CONSENT_STATUS_UNSPECIFIED' | 'CONSENT_STATUS_GRANTED' | 'CONSENT_STATUS_DENIED' — Represents consent for ad personalization.
      - `adUserData` 'CONSENT_STATUS_UNSPECIFIED' | 'CONSENT_STATUS_GRANTED' | 'CONSENT_STATUS_DENIED' — Represents consent for ad user data.
    - `mobileDeviceIds` string[] — Optional. A list of mobile device IDs defining Customer Match audience members. The size of mobile_device_ids mustn't be greater than 500,000.
  - `displayMobileAppAudienceSize` string, int64 — Output only. The estimated mobile app audience size in Display network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.
  - `description` string — Optional. The user-provided description of the audience. Only applicable to first party audiences.
  - `name` string — Output only. The resource name of the first party and partner audience.
  - `displayAudienceSize` string, int64 — Output only. The estimated audience size for the Display network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only returned in GET request.
  - `displayMobileWebAudienceSize` string, int64 — Output only. The estimated mobile web audience size in Display network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.
  - `audienceType` 'AUDIENCE_TYPE_UNSPECIFIED' | 'CUSTOMER_MATCH_CONTACT_INFO' | 'CUSTOMER_MATCH_DEVICE_ID' | 'CUSTOMER_MATCH_USER_ID' | 'ACTIVITY_BASED' | 'FREQUENCY_CAP' | 'TAG_BASED' | 'YOUTUBE_USERS' | 'THIRD_PARTY' | 'COMMERCE' | 'LINEAR' | 'AGENCY' — Immutable. The type of the audience.
  - `displayDesktopAudienceSize` string, int64 — Output only. The estimated desktop audience size in Display network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.
  - `firstPartyAndPartnerAudienceType` 'FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED' | 'TYPE_FIRST_PARTY' | 'TYPE_PARTNER' — Output only. Whether the audience is a first party and partner audience.
  - `youtubeAudienceSize` string, int64 — Output only. The estimated audience size for YouTube network. If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits. Only applicable to first party audiences. Only returned in GET request.
  - `audienceSource` 'AUDIENCE_SOURCE_UNSPECIFIED' | 'DISPLAY_VIDEO_360' | 'CAMPAIGN_MANAGER' | 'AD_MANAGER' | 'SEARCH_ADS_360' | 'YOUTUBE' | 'ADS_DATA_HUB' — Output only. The source of the audience.
  - `membershipDurationDays` string, int64 — Optional. The duration in days that an entry remains in the audience after the qualifying event. The set value must be greater than 0 and less than or equal to 540. Only applicable to first party audiences. This field is required if one of the following audience_type is used: * `CUSTOMER_MATCH_CONTACT_INFO` * `CUSTOMER_MATCH_DEVICE_ID`
  - `displayName` string — Optional. The display name of the first party and partner audience.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/displayvideo.md) · [All operations](https://skmtc.dev/google/apis/displayvideo/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/displayvideo/revisions/68b64e49eced/schema)