---
ref: tool:clay/create-audience
name: Create an audience
company: company:clay
workflows: []
access: [cli]
tags: [capability:build-audience, category:data-provider, has:cli]
docs: https://developers.clay.com/use-cases/enrich-leads-and-accounts
updated: 2026-09-26
---

# Create an audience

Saves a segment of the workspace's own people or companies from a filter, with membership that updates as records change.

Note: Audiences must be enabled for the workspace first.

## Set up

Use the first option your agent supports.

### CLI (official)

Install the command and sign in with it, then confirm it runs.

```sh
npm install --global @clay-run/cli
clay --version
```

Run `clay audiences create`.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.