---
title: "Send Bulk Email"
method: POST
path: "/api/admin/emails/send"
tags: ["admin-emails"]
---

# Send Bulk Email

`POST /api/admin/emails/send`

Send a templated email to the given users and to the contact address of
the given teams (subject + body, personalized with each recipient's name).

Authorizes ``emails:create`` per recipient, so a scoped grant may email only
the users/teams it names while a broad grant may email anyone.

## Request body

- SendBulkEmailRequest — Send a templated email to one or more users and/or team addresses.
  - `userIds` string[]
  - `teamIds` string[]
  - `subject` string, required
  - `body` string, required

## Response `200`

Successful Response

- GenericResponseSendBulkEmailResponse
  - `data` SendBulkEmailResponse
    - `sent` integer, required
    - `unresolvedUserIds` string[]
    - `unresolvedTeamIds` string[]
  - `status` string, nullable — Response status

## Other responses

- `401` — Authorization failed
- `403` — Insufficient permissions
- `422` — Invalid request data

---

[API](https://skmtc.net/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.net/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primeintellect/pi-api/revisions/3d3868828a78/schema)