All tools
ClayC

by Clay

Create an audience

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

View on GitHub
Updated Sep 26, 2026Available asCLI

Description

Audiences must be enabled for the workspace. The segment can trigger a Workflow or be referenced in a search to exclude records you already have.

create-audience.md

Create an audience

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

Audiences must be enabled for the workspace. The segment can trigger a Workflow or be referenced in a search to exclude records you already have.

Set up

Use the first option your agent supports.

CLI (official)

Install the command, then confirm it runs.

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

Run clay audiences create.

Before doing anything else, make one read-only call to confirm access.

Rules

  • Ask the user before anything that sends messages, costs money, or changes data.
  • Never print API keys.

Built from these files in the repository

The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.

Ways in

RouteSourceCallRequiredDocs
CLIOfficialclay audiences createOAuthDocs

Workflows using Create an audience

No workflows yet
No published workflow uses Create an audience yet.