---
title: "Preview Email Notification Audience Users"
method: POST
path: "/api/v1/admin/email-notifications/preview-audience-users"
tags: ["Admin APIs", "email-notifications"]
---

# Preview Email Notification Audience Users

`POST /api/v1/admin/email-notifications/preview-audience-users`

## Request body

- AudiencePreviewRequest — Payload for ``POST /email-notifications/preview-audience``.
  - `audience` AudienceFilter, required — Audience filter as sent by the UI and stored (denormalised) on the ``email_notifications`` row. Validator guarantees the selector fields match ``mode`` so the resolver doesn't have to second-guess the input.
    - `mode` 'all' | 'plan-tier' | 'clients' | 'dataset-access' | 'users', required
    - `plan_tiers` string[], nullable
    - `client_ids` string[], nullable
    - `asset_ids` string[], nullable
    - `user_ids` string[], nullable

## Response `200`

Successful Response

- AudienceUserItem[]
  - `email` string, required
  - `first_name` string, nullable, required
  - `last_name` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)