---
title: "Send Postal Code SMS"
method: POST
path: "/ws/v1/sms/postal/send"
tags: ["Send/PostalCode"]
---

# Send Postal Code SMS

`POST /ws/v1/sms/postal/send`

## Request

- Base URL: `https://api.iranpayamak.com`
- URL: `https://api.iranpayamak.com/ws/v1/sms/postal/send`
- Auth: API key in header `Api-Key`

## Headers

- `Accept` string

## Request body

- object
  - `text` string, required
  - `number_format` 'english' | 'persian', required
  - `line_id` integer, required
  - `schedule` string, date-time, nullable, required: Optional. Omit it or send null to send immediately. A future "YYYY-MM-DD HH:MM:SS" schedules the send — the message is accepted and its cost is reserved at submit time, and it is delivered at that moment, not now. A past date is rejected with a validation error.
  - `filters` object[], required
    - `postal_code` string, required
    - `gender_id` integer, required
    - `age_from` integer, required
    - `age_to` integer, required
    - `number_prefix` string, nullable, required
    - `operator` 'mci' | 'irancell' | 'other', nullable, required
    - `row_from` integer, required
    - `row_count` integer, required

## Other responses

- `401`

---

[API](https://skmtc.dev/farazsms/apis/farazsms-public-apis.md) - [All operations](https://skmtc.dev/farazsms/apis/farazsms-public-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/farazsms/apis/farazsms-public-apis/revisions/e80a7c5dea3f?raw)