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

# Send a text message

> Send an SMS, LMS, or MMS.

> [!WARNING]
>
> * To send text messages through the API, configure Notifly's own SMS delivery and register a sender number.
> * The API sends from a number registered in that configuration.
> * Contact [contact@notifly.tech](mailto:contact@notifly.tech) for API send statistics. The console does not display those statistics.


## OpenAPI

````yaml /en/api-reference/openapi.yaml post /messages/text-message
openapi: 3.0.3
info:
  title: Notifly API
  version: 1.0.0
  contact:
    email: contact@notifly.tech
servers:
  - url: https://api.notifly.tech
    description: Notifly API server
security: []
tags:
  - name: catalog
    x-group: Catalogs
paths:
  /messages/text-message:
    post:
      summary: send-text-message
      operationId: sendTextMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - projectId
                - type
                - body
                - recipientList
              properties:
                projectId:
                  type: string
                  description: Available on the Notifly Settings page.
                type:
                  type: string
                  enum:
                    - sms
                    - lms
                    - mms
                  description: Message type.
                title:
                  type: string
                  description: Message title. Used for LMS and MMS only.
                body:
                  type: string
                  description: Message body.
                sendNo:
                  type: string
                  description: >-
                    Sender number to use if multiple sender numbers are
                    registered.
                recipientList:
                  type: array
                  items:
                    type: object
                    required:
                      - recipientNo
                    properties:
                      recipientNo:
                        type: string
                        description: Recipient phone number.
                  description: List of recipients. Up to 1,000 entries.
            example:
              projectId: example_project_1234567890abcdef
              type: sms
              body: Message Body
              recipientList:
                - recipientNo: '01012345678'
      responses:
        '200':
          description: The message was sent.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
              example:
                success: true
        '400':
          description: The sender information is not registered.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: string
                    nullable: true
                  error:
                    type: string
              example:
                data: null
                error: Sender info is not registered.
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
              example:
                success: false
                error: Internal Server Error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Pass the token issued by `POST /authenticate` as a bearer token.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.