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

# Send a template message

> Sends an approved utility, authentication, or marketing template to one recipient.

<Tip>Confirm the template is `APPROVED` before sending. New templates begin in `PENDING` state.</Tip>


## OpenAPI

````yaml /api-reference/meta/openapi.yaml post /meta/phone-numbers/{phoneNumberId}/messages/template
openapi: 3.1.0
info:
  title: Eazybe Meta API Documentation
  version: 1.0.0
  description: |
    A single authenticated Eazybe REST surface over WhatsApp Business Cloud API.
    The wrapper uses the Meta credentials captured when a WABA is connected to
    Eazybe, so callers never send Meta access tokens directly.
servers:
  - url: https://cerberus.eazybe.com/staging/api/v2
    description: Eazybe staging API v2.
security:
  - bearerAuth: []
tags:
  - name: Phone numbers
    description: Discover connected WABAs and phone-number IDs.
  - name: Messaging
    description: Send WhatsApp messages and update message state.
  - name: Templates
    description: Manage WhatsApp message templates.
  - name: Media
    description: Upload, inspect, and delete WhatsApp media.
  - name: Webhooks
    description: Manage WABA webhook subscriptions.
  - name: Analytics
    description: Read messaging, conversation, pricing, and template analytics.
  - name: Profiles and settings
    description: Manage business profiles and phone-number settings.
  - name: Automation
    description: Configure welcome messages, ice-breakers, and commands.
  - name: QR codes
    description: Manage click-to-chat QR codes.
  - name: Flows
    description: Manage the WhatsApp Flows lifecycle.
  - name: Number administration
    description: Register numbers, manage PINs, and synchronize coexistence data.
  - name: Block list
    description: List, block, and unblock WhatsApp users.
paths:
  /meta/phone-numbers/{phoneNumberId}/messages/template:
    post:
      tags:
        - Messaging
      summary: Send a template message
      description: >-
        Sends an approved utility, authentication, or marketing template to one
        recipient.
      operationId: sendTemplateMessage
      parameters:
        - $ref: '#/components/parameters/PhoneNumberId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - to
                - template
              properties:
                to:
                  type: string
                template:
                  type: object
                  required:
                    - name
                    - language
                    - components
                  properties:
                    name:
                      type: string
                    language:
                      type: object
                      properties:
                        code:
                          type: string
                      required:
                        - code
                    components:
                      type: array
                      items:
                        type: object
                        required:
                          - type
                          - parameters
                        properties:
                          type:
                            type: string
                          parameters:
                            type: array
                            items:
                              type: object
                              required:
                                - type
                                - text
                              properties:
                                type:
                                  type: string
                                text:
                                  type: string
              description: |-
                ```json
                {
                  "to": "919900000001",
                  "template": {
                    "name": "order_update",
                    "language": {
                      "code": "en"
                    },
                    "components": [
                      {
                        "type": "body",
                        "parameters": [
                          {
                            "type": "text",
                            "text": "Ravi"
                          }
                        ]
                      }
                    ]
                  }
                }
                ```
            example:
              to: '919900000001'
              template:
                name: order_update
                language:
                  code: en
                components:
                  - type: body
                    parameters:
                      - type: text
                        text: Ravi
      responses:
        '200':
          description: >-
            Template accepted for delivery


            **Failure responses**


            | **Status** | **Meaning** | **Action** |

            | --- | --- | --- |

            | `401` | Missing, invalid, or expired bearer token |
            Re-authenticate |

            | `404` | `phoneNumberId` not linked to your organization | Verify
            the id |

            | `500` | Template name/language not found, template not approved,
            or parameter count mismatch | Confirm the template is `APPROVED` and
            parameters match |
          content:
            application/json:
              schema:
                type: object
                required:
                  - messaging_product
                  - contacts
                  - messages
                properties:
                  messaging_product:
                    type: string
                  contacts:
                    type: array
                    items:
                      type: object
                      required:
                        - input
                        - wa_id
                      properties:
                        input:
                          type: string
                        wa_id:
                          type: string
                  messages:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - message_status
                      properties:
                        id:
                          type: string
                        message_status:
                          type: string
              example:
                messaging_product: whatsapp
                contacts:
                  - input: '919900000001'
                    wa_id: '919900000001'
                messages:
                  - id: wamid.HBgMOTE5OTAwMDAwMDAxFQIAERgSN0EyRjc4...
                    message_status: accepted
components:
  parameters:
    PhoneNumberId:
      name: phoneNumberId
      in: path
      required: true
      description: Meta phone-number ID returned by `GET /meta/phone-numbers`.
      schema:
        type: string
      example: '5647382910'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Eazybe token
      description: |
        Eazybe bearer token. The token resolves the caller's organization and
        must be kept on the server.

````