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

# Preview Email Notification Audience

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

## 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

- AudiencePreviewResponse
  - `recipient_count` integer, required
  - `client_count` integer, 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)