---
title: "Updates audience by ID"
method: PUT
path: "/marketing/v1/audiences/{audienceId}"
tags: ["Audiences"]
---

# Updates audience by ID

`PUT /marketing/v1/audiences/{audienceId}`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/marketing/v1/audiences/{audienceId}`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:audience:manage`

Updates an existing audience.

## Path parameters

- `audienceId` string, required

## Request body

- AudienceModelUpdate: Response containing a single ZoomInfo Audience
  - `data` AudienceUpdate, required: ZoomInfo Audience
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` AudienceAttributesUpdate, required: Attributes defining a ZoomInfo Audience
      - `name` string, required: The name of the audience

## Response `200`

Success

- AudienceModel: Response containing a single ZoomInfo Audience
  - `data` Audience, required: ZoomInfo Audience
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` AudienceAttributes, required: Attributes defining a ZoomInfo Audience
      - `name` string, required: The name of the audience
      - `type` 'B2B' | 'B2C', required
      - `status` 'ACTIVE' | 'ARCHIVED', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/marketing-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/marketing-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/marketing-api-v1/revisions/5948105477fd?raw)