---
title: "Estimate push campaign recipients"
method: POST
path: "/push/campaigns/estimate"
tags: ["Push"]
---

# Estimate push campaign recipients

`POST /push/campaigns/estimate`

## Request

- Base URL: `https://api.sequenzy.com/api/v1`
- URL: `https://api.sequenzy.com/api/v1/push/campaigns/estimate`
- Auth: HTTP bearer

Counts the contacts in an audience (audienceCount) and those with an active device on the selected platforms (eligibleCount). Email status does not affect push eligibility. Requires the campaigns:read scope.

## Request body

- object
  - `targetLists` object, required: Audience, same shape as campaign targetLists.
  - `platforms` string[]

## Response `200`

Estimate

- object
  - `success` boolean
  - `audienceCount` integer
  - `eligibleCount` integer

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Missing campaigns:read scope
- `500`: Server error

## Changes

- **2026-10-16** `db3873ca3d4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/push/campaigns/estimate/post.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) - [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/8156dc12d8b4?raw)
