> ## Documentation Index
> Fetch the complete documentation index at: https://smsmanager.cz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Odeslání jednoduché zprávy (POST request)

> Zjednodušené odeslání jedné SMS pomocí formulářových parametrů. Pro plnou funkčnost (flow, více příjemců, doručovací okno, ...) použijte `/message`.




## OpenAPI

````yaml /openapi/json/jsonapi_v2.yaml post /simple/message
openapi: 3.1.0
info:
  title: JSON API
  description: >
    API pro odesílání zpráv přes SMS, Viber, WhatsApp, RCS a další komunikační
    kanály.


    ## JSON API v2


    API klíč je vyžadován pro všechny požadavky. Svůj API klíč najdete v
    [nastavení účtu](https://app.smsmanager.com/api-cloud).


    Starší verze API (http-api a xml-api) jsou zastaralé a místo nich byste měli
    používat toto JSON API v2.
  version: v2
  contact:
    url: https://smsmanager.cz
    email: cc@smsmanager.cz
servers:
  - url: https://api.smsmngr.com/v2
    description: Odpoví s daty vašeho požadavku
security: []
tags:
  - name: sending
    x-displayName: Odesílání
    description: >
      Pro odesílání zpráv použijte jeden z následujících endpointů.

      - `/message` pro odeslání zprávy až 10 příjemcům

      - `/message/priority` pro odeslání prioritní zprávy (zpracována prioritní
      frontou)

      - `/messages` pro odeslání více zpráv (až 10 zpráv najednou)

      - `/simple/message` pro odeslání jednoduché zprávy (GET a POST)
paths:
  /simple/message:
    post:
      tags:
        - sending
      summary: Odeslání jednoduché zprávy (POST request)
      description: >
        Zjednodušené odeslání jedné SMS pomocí formulářových parametrů. Pro
        plnou funkčnost (flow, více příjemců, doručovací okno, ...) použijte
        `/message`.
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - phone_number
                - message
                - sender
              properties:
                phone_number:
                  type: string
                  description: Telefonní číslo příjemce (akceptován je i alias `number`).
                  example: '420777123456'
                message:
                  type: string
                  description: Tělo zprávy (akceptován je i alias `body`).
                sender:
                  type: string
                  description: >-
                    Název odesílatele nebo virtuální číslo (může být vyžadována
                    předchozí registrace).
                gateway:
                  type: string
                  enum:
                    - high
                    - lowcost
                    - direct
                    - custom
                    - simhost
                    - gsm
                  default: high
                  description: SMS brána použitá pro odeslání.
                datetime:
                  type: string
                  format: date-time
                  description: >-
                    Naplánovaný čas odeslání zprávy, v UTC (akceptován je i
                    alias `time`).
                  example: '2025-01-11T10:00:00Z'
                customID:
                  type: string
                  description: >-
                    Váš vlastní identifikátor zprávy. Je uložen v `payload`
                    zprávy (jako `customID`) a vrácen v notifikacích o doručení.
            examples:
              Basic message:
                value:
                  phone_number: '420777123456'
                  message: Test message
                  sender: Mojefirma
              Message with customID:
                value:
                  phone_number: '420777123456'
                  message: Order confirmed
                  sender: Mojefirma
                  customID: ORD-1001
              Scheduled message:
                value:
                  phone_number: '420777123456'
                  message: Meeting reminder
                  sender: Mojefirma
                  datetime: '2025-01-11T10:00:00Z'
      responses:
        '200':
          description: Jednoduchá zpráva byla úspěšně odeslána
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageSimpleResponse'
              examples:
                Accepted message:
                  value:
                    request_id: 11111111-1111-1111-1111-111111111111
                    message_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
                    accepted: true
                Rejected invalid number:
                  value:
                    request_id: 22222222-2222-2222-2222-222222222222
                    accepted: false
                Rejected insufficient credit:
                  value:
                    request_id: 33333333-3333-3333-3333-333333333333
                    accepted: false
                Accepted promo message:
                  value:
                    request_id: 44444444-4444-4444-4444-444444444444
                    message_id: ffffffff-gggg-hhhh-iiii-jjjjjjjjjjjj
                    accepted: true
                Accepted transactional message:
                  value:
                    request_id: 55555555-5555-5555-5555-555555555555
                    message_id: kkkkkkkk-llll-mmmm-nnnn-oooooooooooo
                    accepted: true
        '400':
          description: Neplatný požadavek
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    description: Unikátní identifikátor požadavku.
                    example: bc36f3d1-d284-463a-921b-a3560c154649
                  accepted:
                    type: boolean
                    description: >-
                      True, pokud byla zpráva přijata, false, pokud byla
                      odmítnuta.
                    example: false
        '415':
          description: Špatný Content-Type
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: >-
                      Podporován je pouze
                      Content-Type:application/x-www-form-urlencoded
                    example: 'Unsupported Media Type '
      security:
        - x-api-key: []
components:
  schemas:
    MessageSimpleResponse:
      type: object
      properties:
        request_id:
          type: string
          description: Unikátní identifikátor požadavku.
          example: bc36f3d1-d284-463a-921b-a3560c154649
        message_id:
          type: string
          description: Unikátní identifikátor zprávy.
          example: bc36f3d1-d284-463a-921b-a3560c154649
        accepted:
          type: boolean
          description: True, pokud byla zpráva přijata, false, pokud byla odmítnuta.
          example: true
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````