---
title: "Send-Message"
method: POST
path: "/messages"
tags: ["Messages"]
---

# Send-Message

`POST /messages`

## Request body

- SendMessageRequestBody
  - `to` string, required — When recipient_type is individual, this field is the WhatsApp ID (phone number) returned from contacts endpoint. When recipient_type is group, this field is the WhatsApp group ID.
  - `type` 'audio' | 'contacts' | 'document' | 'hsm' | 'image' | 'location' | 'text' | 'video' | 'voice' | 'unknown' — type of the message
  - `recipient_type` 'individual' | 'group' — Determines whether the recipient is an individual or a group Specifying recipient_type in the request is optional when the value is individual. However, recipient_type is required when using group. If sending a text message to a group, see the Sending Group Messages documentation.
  - `text` Text
    - `body` string, required
  - `audio` union — The media object containing audio
    - object
      - `id` string, required
    - object
      - `provider` Provider, required
        - `name` string, required
      - `link` string, required
  - `image` union — The media object containing an image
    - object
      - `caption` string, required
      - `id` string, required
    - object
      - `provider` Provider, required
        - `name` string, required
      - `link` string, required
      - `caption` string, required
  - `document` union — The media object containing a document
    - object
      - `caption` string, required
      - `id` string, required
      - `filename` string, required
    - object
      - `provider` Provider, required
        - `name` string, required
      - `caption` string, required
      - `link` string, required
      - `filename` string, required
  - `video` union — The media object containing a video
    - object
      - `caption` string, required
      - `id` string, required
    - object
      - `provider` Provider, required
        - `name` string, required
      - `caption` string, required
      - `link` string, required
  - `hsm` Hsm — The containing element for the message content — Indicates that the message is highly structured. Parameters contained within provide the structure.
    - `namespace` string, required — The namespace that will be used
    - `element_name` string, required — The element name that indicates which template to use within the namespace
    - `language` Language, required
      - `policy` 'fallback' | 'deterministic', required — The language policy the message should follow
      - `code` string, required — The code of the language or locale to use — Accepts both language and language_locale formats (e.g., en and en_US).
    - `localizable_params` LocalizableParam[], required — This field is an array of values to apply to variables in the template
      - `default` string, required — Default text if localization fails
      - `currency` Currency
        - `currency_code` string, required
        - `amount_1000` integer, required
      - `date_time` DateTimeObject — The Whatsapp Business API Client will attempt to format the date/time based on a specified localization.
        - `component` DateTimeComponent — Date/time by component
          - `day_of_week` integer — Both strings and numbers are accepted. If different from the value derived from the date (if specified), use the derived value.
          - `day_of_month` integer — The day of month
          - `year` integer — The year
          - `month` integer — The month
          - `hour` integer — The hour
          - `minute` integer — The minute
        - `unix_epoch` DateTimeUnixEpoch — Date/time by Unix epoch
          - `timestamp` integer — Epoch timestamp in seconds
  - `ttl` object
  - `contacts` Contact[]
    - `addresses` Address[] — Full contact address(es)
      - `city` string, required — City name
      - `country` string, required — Full country name
      - `country_code` string, required — Two-letter country abbreviation
      - `state` string, required — State abbreviation
      - `street` string, required — Street number and name
      - `type` string, required — Standard Values: HOME, WORK
      - `zip` string, required — ZIP code
    - `birthday` string — YYYY-MM-DD formatted string
    - `emails` Email[] — Contact email address(es)
      - `email` string, required
      - `type` string, required
    - `ims` string[]
    - `name` Name — Full contact name
      - `first_name` string — First name
      - `formatted_name` string, required — Full name as it normally appears
      - `last_name` string — Last name
      - `suffix` string — Name suffix
      - `prefix` string — Name preffix
    - `org` Org — Contact organization information
      - `company` string, required — Name of the contact's company
      - `department` string — Name of the contact's department
      - `title` string — Contact's business title
    - `phones` Phone[] — Contact phone number(s)
      - `phone` string
      - `type` string — Standard Values: CELL, MAIN, IPHONE, HOME, WORK
      - `wa_id` string — WhatsApp ID
    - `urls` Url[] — Contact URL(s)
      - `url` string — URL
      - `type` string — Standard Values: HOME, WORK
  - `location` Location
    - `longitude` string, required — Longitude of the location
    - `latitude` string, required — Latitude of the location
    - `name` string, required — Name of the location
    - `address` string, required — Address of the location. Only displayed if name is present.
  - `preview_url` boolean — Specifying preview_url in the request is optional when not including a URL in your message. To include a URL preview, set preview_url to true in the message body and make sure the URL begins with http:// or https://. For more information, see the Sending URLs in Text Messages section.

## Response `200`

- MessageResponse
  - `meta` Meta — Contains generic information such as WhatsApp Business API Client version.
    - `version` string
    - `api_status` 'deprecated' | 'experimental' | 'stable'
  - `errors` Error[] — Only returned with a failed request. Contains an array of error objects that are present when there is an error.
    - `code` integer — See the https://developers.facebook.com/docs/whatsapp/api/errors for more information.
    - `title` string — error title
    - `details` string — error detail
    - `href` string — location for error detail
  - `messages` Message[]
    - `id` string

---

[API](https://skmtc.net/unblu/apis/whatsapp-business-api.md) · [All operations](https://skmtc.net/unblu/apis/whatsapp-business-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unblu/whatsapp-business-api/versions/7a5937fc6885/schema)