Manage Audience Rows
Load records into an audience and set or correct cell values. Synchronous, up to 50 rows per call. Data credits on matched rows only.
Overview
Manage Audience Rows is how your own data gets into an audience, and how individual cells get set or corrected afterward.
Use it when the records come from you. A CRM export, a CSV, trade show scans, a list someone handed you. Records sourced from ZoomInfo search arrive through Upsert Audience instead and aren't subject to this tool's batch limit.
What You'll Get
The resulting rows, returned directly. The call is synchronous.
Ingested records are matched against ZoomInfo automatically, and the match populates a baseline set of fields on every row it resolves, before you add a single AI column:
- Company audiences: company name, industry, employee range, revenue range, HQ country, and the ZoomInfo company ID
- Contact audiences: first name, last name, business email, job title, management level, and job function
The ZoomInfo ID is the one to know about. It ties the row back to the identity graph, which is what makes later enrichment resolve to the right entity rather than a name-similar one. Rows that don't match come in without these fields; they're still fully usable, and AI columns run on them. The qualifications are per capability, matched or unmatched: conversation intelligence only returns values for records your team has actually talked to, and email writing works at the person level, so it applies to contact audiences.
Best For
- Loading your own records into an audience
- Correcting or backfilling specific cells without touching the rest of the row
- Setting values in plain columns, like owner, tier, or status
- Mixed operations that update some rows and add others in one call
To create the audience, use Upsert Audience first; to add or rename columns, Manage Audience Columns; to find existing rowId and columnId values, Get Audience. To run enrichment across your rows, open the audience in ZoomInfo.
How It Works
Create. Omit rowId and include at least one cell in values; columns without a cell are left blank.
Update. Provide rowId and include only the cells you want to change. Everything else keeps its current value.
Creates and updates can be mixed in a single call, with a ceiling of 50 rows per call. Larger loads split across multiple calls, so a 400-row list is eight of them. The limit applies to records you supply; audiences populated from ZoomInfo search criteria run as a job through Upsert Audience with no such ceiling.
Each cell's value must match its column's dataType. A string sent to an INTEGER column, or a scalar sent to a list column, returns an error. Look up the column definition through Get Audience if you're unsure.
Technical Details
Credits
Loading your own records costs data credits on matched rows only, meaning rows ZoomInfo can resolve to a record in its graph. That credit buys the baseline company or contact fields described above. Records Under Management applies: anything your organization enriched in the last 12 months is free to bring in again.
Rows that don't match ingest free and stay fully usable. AI enrichment columns run on unmatched rows exactly as on matched ones, subject to the same per-capability limits described above. Updating cells on existing rows is free. See Credits & Billing.
Requirements
A ZoomInfo subscription with bulk data credits enabled. The audienceId comes from Browse Audiences, Get Audience, or the Upsert Audience create response.
Automatic Tool Selection
The AI reaches for Manage Audience Rows when you supply records or ask to change specific values. If it's unclear whether you mean to add new rows or update existing ones, it should ask rather than guess.
Architecture
Synchronous by design. The response returns the resulting rows, so an agent can verify what landed before moving on. That matters when chaining calls for a large load: each 50-row batch confirms itself before the next one goes out.
Example Prompts
"Load these 40 trade show leads into my Events audience."
"Set the owner on these twelve accounts to jsmith."
"The pricing column is blank for these five rows; fill them in with these values."
"Add this account to the win-back audience and mark it Tier A."