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

# Envoie un SMS à un numéro

> Envoie un SMS à un numéro, ou un envoi groupé (`type: bulk`) à des numéros, des groupes de contacts ou un fichier : réserve, met en file, répond sans attendre



## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/sms/messages
openapi: 3.1.0
info:
  title: API DexNotify
  version: '1'
  description: >-
    SMS, e-mail, WhatsApp, notifications push, contacts et campagnes, par une
    seule API. Authentification par clé API dans l’en-tête `x-api-key`.
servers:
  - url: https://api.dexnotify.com
    description: Production et staging
security:
  - api-key: []
tags:
  - name: SMS
  - name: E-mail
  - name: WhatsApp
  - name: Contacts
  - name: Listes de contacts
  - name: Campagnes
  - name: Modèles e-mail
  - name: Automatisations
  - name: Notifications push
  - name: Campagnes push
  - name: Journal des messages
  - name: In-app
  - name: Live Activities
  - name: Utilisateurs et appareils
  - name: Segments
  - name: Modèles push
  - name: Événements
  - name: Statistiques
paths:
  /api/v1/sms/messages:
    post:
      tags:
        - SMS
      summary: >-
        Envoie un SMS à un numéro, ou un envoi groupé (`type: bulk`) à des
        numéros, des groupes de contacts ou un fichier : réserve, met en file,
        répond sans attendre
      operationId: SmsMessagesController_send_v1
      parameters:
        - name: idempotency-key
          in: header
          description: >-
            Clé de rejeu propre à un projet et à un environnement. Rejouée avec
            la même demande, elle rend le même envoi : un seul message, une
            seule réservation, un seul job. Employée pour un autre envoi, elle
            est refusée en 409.
          required: false
          schema:
            type: string
            minLength: 8
            maxLength: 255
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - type: object
                  properties:
                    type:
                      type: string
                      const: single
                    sender:
                      type: string
                      minLength: 1
                      maxLength: 11
                    to:
                      type: string
                    content:
                      type: string
                      minLength: 1
                    scheduledAt:
                      type: string
                    timezone:
                      default: Africa/Dakar
                      type: string
                    templateId:
                      type: string
                      pattern: ^[0-9a-fA-F]{24}$
                    variables:
                      type: object
                      propertyNames:
                        type: string
                        pattern: ^[A-Za-z_][A-Za-z0-9_]{0,31}$
                      additionalProperties:
                        type: string
                        maxLength: 200
                  required:
                    - sender
                    - to
                - type: object
                  properties:
                    type:
                      type: string
                      const: bulk
                    sender:
                      type: string
                      minLength: 1
                      maxLength: 11
                    content:
                      type: string
                      minLength: 1
                    templateId:
                      type: string
                      pattern: ^[0-9a-fA-F]{24}$
                    variables:
                      type: object
                      propertyNames:
                        type: string
                        pattern: ^[A-Za-z_][A-Za-z0-9_]{0,31}$
                      additionalProperties:
                        type: string
                        maxLength: 200
                    to:
                      maxItems: 10000
                      type: array
                      items:
                        type: string
                    groupIds:
                      default: []
                      maxItems: 20
                      type: array
                      items:
                        type: string
                        pattern: ^[0-9a-fA-F]{24}$
                    fileId:
                      type: string
                      pattern: ^[0-9a-fA-F]{24}$
                    scheduledAt:
                      type: string
                    timezone:
                      default: Africa/Dakar
                      type: string
                  required:
                    - type
                    - sender
      responses:
        '202':
          description: Envoi accepté (`queued`), unités réservées
      security:
        - api-key: []
components:
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Clé API du projet, créée dans le dashboard (Développeurs › Clés API et
        SDK). Une clé `dxn_prod_` vise la production, une clé `dxn_stag_` le
        staging.

````

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