---
title: "Sets the included monthly active users on an identity (subscription plans / sales). Idempotent by `reason`, mirroring the quota endpoint."
method: POST
path: "/admin/identities/{email}/mau-included"
tags: ["admin"]
---

# Sets the included monthly active users on an identity (subscription plans / sales). Idempotent by \`reason\`, mirroring the quota endpoint.

`POST /admin/identities/{email}/mau-included`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/admin/identities/{email}/mau-included`
- Auth: HTTP bearer

## Path parameters

- `email` string, required

## Request body

- SetMauIncludedRequest: Body for `POST /admin/identities/{email}/mau-included`.
  - `mau` integer, required: New included monthly active users for the identity (>= 0). Plans raise it; cancellation resets it to the free default.
  - `reason` string, required: Idempotency reason, e.g. `stripe-sub:sub_…:1750000000`. Repeating a reason is a no-op returning the recorded value.

## Response `200`

Included MAU applied (or unchanged, when the reason was replayed)

- MauIncludedResponse: Response for `POST /admin/identities/{email}/mau-included`.
  - `duplicate` boolean, required: `true` when the reason had already been applied (idempotent replay; nothing changed).
  - `email` string, required: Canonical (lowercased) identity email.
  - `mau_included` integer, required: The included MAU now recorded for this reason.

## Other responses

- `400`: Invalid mau or reason
- `401`: Missing or wrong admin token
- `404`: Unknown identity email

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)