# How to use


<div style="margin-top:0.5rem;margin-bottom:1.5rem;">
{{< hextra/hero-subtitle >}}
  Step-by-step guides for the things people do most.
{{< /hextra/hero-subtitle >}}
</div>

Each guide shows the requests in full, with the responses to expect.

## Where to start

Most journeys follow the same three steps:

{{% steps %}}

### Look up the ids you need

Brands, places, apps, geography, and the other catalogs an audience is built
from. [Working with Reference Data](/guides/working-with-reference-data)

### Build an audience

Pick a dataset and its filters, and wait for the audience to finish building.
[Create an Audience](/guides/create-an-audience)

### Deliver it

Send the finished audience to one of your destinations.
[Activate an Audience](/guides/activate-an-audience)

{{% /steps %}}

## Build

{{< cards >}}
  {{< card link="/developers/guides/working-with-reference-data/" title="Working with Reference Data" icon="search" subtitle="Find the ids and values an audience needs, dataset by dataset." >}}
  {{< card link="/developers/guides/create-an-audience/" title="Create an Audience" icon="user-group" subtitle="Build an audience from one or two datasets, and wait for it to complete." >}}
  {{< card link="/developers/guides/build-a-lookalike-model/" title="Build a Lookalike Model" icon="sparkles" subtitle="Grow a finished audience into a larger one of similar devices." >}}
  {{< card link="/developers/guides/cloud-cohort-to-activation/" title="Cloud Cohort to Activation" icon="cloud-upload" subtitle="From a file in your own S3 or GCS to a cohort, an audience, and a delivery." >}}
  {{< card link="/developers/guides/submit-poi-data/" title="Submit POI Data" icon="location-marker" subtitle="Send your own locations by file or by list, and follow their review." >}}
{{< /cards >}}

## Deliver

{{< cards >}}
  {{< card link="/developers/guides/activate-an-audience/" title="Activate an Audience" icon="arrow-circle-right" subtitle="Deliver a finished audience to an endpoint connection, and read the results." >}}
  {{< card link="/developers/guides/deliver-to-a-partner-endpoint/" title="Deliver to a Partner Endpoint" icon="truck" subtitle="Partner by partner: the connection, pricing, datastreams, and account inputs." >}}
  {{< card link="/developers/mcp/preview-and-activate/" title="Preview, then Activate" icon="eye" subtitle="With an AI agent: count the devices a frequency range would deliver, then deliver exactly that." >}}
{{< /cards >}}

## Read and manage

{{< cards >}}
  {{< card link="/developers/guides/read-an-audience/" title="Read an Audience" icon="document-text" subtitle="Fetch one audience by id, and understand its status." >}}
  {{< card link="/developers/guides/read-an-activation/" title="Read an Activation" icon="document-text" subtitle="Fetch one activation by id, and read what it delivered." >}}
  {{< card link="/developers/guides/list-get-and-delete/" title="List, Get & Delete" icon="collection" subtitle="Page through, read, and clean up your audiences and activations." >}}
{{< /cards >}}

## Automate

{{< cards >}}
  {{< card link="/developers/guides/polling-and-rate-limits/" title="Polling & Rate Limits" icon="refresh" subtitle="How often to check, honoring Retry-After, and retrying safely." >}}
  {{< card link="/developers/guides/automate-with-an-ai-agent/" title="Automate with an AI Agent" icon="chip" subtitle="Run these journeys from an agent: look up, create, wait, and deliver." >}}
  {{< card link="/developers/mcp/getting-started/" title="Connect an MCP Client" icon="chat" subtitle="Connect Claude, Cursor, or your own agent, in one click or with a token." >}}
{{< /cards >}}