---
title: "Send Custom Sms"
method: POST
path: "/admin/custom-notifications/sms"
tags: ["admin", "admin-api-key", "custom-notifications"]
---

# Send Custom Sms

`POST /admin/custom-notifications/sms`

## Request

- Base URL: `https://api.trytrata.com`
- URL: `https://api.trytrata.com/admin/custom-notifications/sms`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Trata-Api-Key`

## Request body

- SendCustomSmsRequest
  - `user_ids` string[], required
  - `body` string, required

## Response `200`

Successful Response

- SendCustomNotificationResponse
  - `custom_notification_id` string, uuid, required
  - `results` RecipientResultResponse[], required
    - `user_id` string, required
    - `status` 'sent' | 'skipped_no_phone' | 'skipped_no_email' | 'skipped_lookup_failed' | 'skipped_opt_out' | 'failed', required
    - `error` string, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

## Changes

- **2026-10-28** `86e84046aceb`: 1 info
  - api tag `admin-api-key` added
- **2026-10-06** `6a36db225fa7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytrata/apis/fastapi/changes/admin/custom-notifications/sms/post.md)

---

[API](https://skmtc.dev/trytrata/apis/fastapi.md) - [All operations](https://skmtc.dev/trytrata/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/trytrata/apis/fastapi/revisions/580522e6d1af?raw)