---
title: "Add sender"
method: POST
path: "/senders"
tags: ["Senders"]
---

# Add sender

`POST /senders`

Create a new sender identity. Both `name` and `value` are required. New senders may require approval before use.

**Authentication:** TextPeak API key in the `Authorization` header (see **Authentication** in the API Overview).

## Request body

- object
  - `name` string, required — Sender display name.
  - `value` string, required — The sender ID or phone number (dashes, spaces, and `+` are stripped).

## Response `201`

The created sender.

- object
  - `id` integer — Unique sender identifier.
  - `name` string — Sender display name.
  - `value` string — The sender ID or phone number used on outbound messages.
  - `dailyLimit` integer — Maximum messages this sender may send per day.
  - `stream` string — IRI of the stream this sender belongs to, if any.
  - `senderType` 'PHONE' | 'ALPHANUMERIC' | 'INBOUND_ONLY' | 'BOT' | 'WHATSAPP' | 'TELEGRAM_PRIVATE' | 'WHATSAPP_PRIVATE' | 'WIDGET' | 'VOICE' — Sender type (read-only, derived from the value).
  - `status` 'WAITING_APPROVE' | 'APPROVED' | 'UNAPPROVED' — Approval status (read-only).

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/versions/eacecf960bb6/schema)