---
title: "Upsert Column Match Criteria"
method: POST
path: "/studio/v1/audiences/{audienceId}/actions/match-criteria"
tags: ["Audiences"]
---

# Upsert Column Match Criteria

`POST /studio/v1/audiences/{audienceId}/actions/match-criteria`

Upserts match criteria for the audience's designated match column (the column used for enrichment matching).
Match criteria define how audience column values are mapped to ZoomInfo attributes (for example, mapping an "Email" column to `CONTACT_EMAIL`) for enrichment resolution.

If a request body is provided, the supplied match criteria are applied directly — each entry maps an audience `columnId` to a ZoomInfo attribute field.
If the request body is omitted or `matchCriteria` is not provided, the system attempts to auto-map match criteria using AI.
If the match column does not exist, it will be created automatically.

Existing match criteria on the audience's match column are replaced by the new values.
Returns `200` with the updated match column resource.
Returns `400` if a `columnId` does not exist in the audience or a `mappedTo` value is invalid.
Returns `404` if no audience matches the provided `audienceId`.

## Path parameters

- `audienceId` string, uuid, required

## Response `200`

Success

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/zoominfo/apis/data-api-v1.md) · [All operations](https://skmtc.net/zoominfo/apis/data-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zoominfo/data-api-v1/revisions/d1ee1374b588/schema)