> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypersender.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Send Text
> Send plain text messages with link preview (optional) to WhatsApp users for basic communication, notifications, and automated messaging.
Send links and simple texts to a WhatsApp
* Chat
* Group
* Recipient
We highly recommend using the [`send-text-safe`](/api-reference/whatsapp/send-messages/send-text-safe) endpoint for regular messaging operations to maintain a more natural communication pattern, and keep your whatsapp number safe from being blocked.
## Sending link preview
If the text has a link - it generates a preview for that link. You can adjust the behaviour by setting
* `link_preview: true` - to enable link preview
* `link_preview_high_quality: true` - to enable high-quality link preview
***
## Quick Demo
**Learn how to use Hypersender whatsapp API to send a message using Postman:** [Demo Link](/api-reference/whatsapp/how-to-send-whatsapp-message-in-postman)
## OpenAPI
````yaml v1/api-reference/whatsapp/whatsapp-collection.json POST /{instance}/send-text
openapi: 3.1.0
info:
version: v1.0
title: Hypersender WhatsApp API Docs
description: >
The Hypersender WhatsApp API is a powerful api to send and recieve messages
using your own whatsapp number.
Without the high costs of Meta's Whatsapp business API.
In this Docs you'll learn how to use and integrate Hypersnder Whatsapp API
into your existing system/service or application using simple API endpoints.
**What you can Do?**
- Send Text and basic Url messages.
- Send Media through Link or uploaded file.
- Send Audio through Link or uploaded file.
- Send Contact Card
- Send Location
- Send Poll votes
**You can also**
- React to a message
- Forward messages to other chats
- Acknowledge messages (mark as read)
- Star and unstar messages
**Quick Demo**
**Learn how to use Hypersender whatsapp API to send a message using Postman:**
[Demo Link](https://app.hypersender.com/send-whatsapp-message-in-postman) **to easily interact with our API.**
**postman collection**
You can download our [Postman
Collection](https://docs.hypersender.com/whatsapp-postman-collection.json)
to easily interact with our API.
## Servers (Endpoints)
- Production (activated):
[https://app.hypersender.com/api/whatsapp/v1](https://app.hypersender.com/api/whatsapp/v1)
servers:
- url: https://app.hypersender.com/api/whatsapp/v1
description: Production
security:
- Authorization: []
paths:
/{instance}/send-text:
post:
tags:
- Send Messages
parameters:
- name: Accept
in: header
description: application/json
schema:
type: string
example: application/json
examples:
default:
value: application/json
- name: Content-Type
in: header
description: application/json
schema:
type: string
example: application/json
examples:
default:
value: application/json
- name: instance
in: path
description: Instance UUID copied from hypersender dashboard
required: true
schema:
type: string
example: '{{ instance_id }}'
examples:
default:
value: '{{ instance_id }}'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SendMessageRequest'
examples:
Example 1:
value:
chatId: 111111111111@c.us
text: Hi there!
reply_to: string
link_preview: false
link_preview_high_quality: false
responses:
'201':
description: Successful response
content:
application/json:
schema:
allOf:
- type: object
properties:
key:
type: object
properties:
remoteJid:
type: string
fromMe:
type: boolean
id:
type: string
message:
type: object
properties:
extendedTextMessage:
type: object
properties:
text:
type: string
messageTimestamp:
type: string
status:
type: string
x-examples:
Example 1:
content:
text: Hi
contextInfo: []
examples:
Example 1:
value:
key:
remoteJid: 111111111@s.whatsapp.net
fromMe: true
id: 3EB0CD3810439716606547
message:
extendedTextMessage:
text: Hi there!
messageTimestamp: 1741359489
status: PENDING
Example 2:
value:
key:
remoteJid: 111111111@s.whatsapp.net
fromMe: true
id: 3EB0CD3810439716606547
message:
extendedTextMessage:
text: https://hypersender.com/
matchedText: https://hypersender.com/
description: >-
Hypersender is a powerful API for sending Whatsapp and
SMS messages. It is designed to be simple and easy to
use, with a focus on security and reliability.
title: 'Hypersender: Whatsapp and SMS APIs'
previewType: NONE
thumbnailDirectPath: >-
/o1/v/t24/f2/m234/AQMWy7W9aoxZqxxRETDx1dXJz6jhTwuZvTV2e1Ep-lbVfAn2vblroFuisfPajGw-hsD2vrHbe4Tn2DuHrqdaytfg8QChweXGPnVMrtrbMg?ccb=9-4&oh=01_Q5Aa2gH8kJkHg-6ZdB18wKj5CqnLiEJ5qlItVfaPNNPIosO6fA&oe=68F1F7ED&_nc_sid=e6ed6c
thumbnailSha256: J22VHFlcIdrEtvvznaB6KFCsUenk1Zb+P6yQvdpKW0I=
thumbnailEncSha256: 1zjk1SGXR7Afyn2WgnKa88EmxmSIbGK68hiACkQ4xL4=
mediaKey: Vt7QDa+t+Wt2fZUbqqUJ4IX9238kgkm1W+N6VVvlzMg=
mediaKeyTimestamp: 1758103675
messageTimestamp: 1758103675
status: PENDING
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
examples:
Multiple fields Error:
value:
message: The given data was invalid.
errors:
messages:
- >-
The number you want to send the message to is not on
whatsapp.
jid: 20121323124131@s.whatsapp.net
exists: false
statusCode: 422
'Single Field error ':
value:
message: The given data was invalid.
errors:
messages:
- textMessage.text should not be empty
statusCode: 422
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ServerError'
examples:
default:
value:
message: Server Error
Example 1:
value:
message: Server Error
security:
- Authorization: []
components:
schemas:
SendMessageRequest:
type: object
properties:
chatId:
type: string
description: >-
Contact number - **learn what is
[`chatId`](https://docs.hypersender.com/docs/whatsapp/what-is-chatid)**
example: 111111111111@c.us
text:
type: string
description: "Text Message\r\n"
reply_to:
type: string
description: "Reply to message id\r\n"
link_preview:
type: boolean
description: "Link Preview\r\n"
link_preview_high_quality:
type: boolean
description: "Link Preview High Quality\r\n"
required:
- chatId
- text
NotFoundError:
type: object
title: NotFoundError
example:
message: Resource not found.
properties:
message:
type: string
x-examples:
Example 1:
message: Resource not found.
x-stoplight:
id: ar3vz55asbxme
ValidationError:
type: object
title: ValidationError
properties:
message:
type: string
errors:
type: object
description: Invalid or missing feilds will be shown here
statusCode:
type: number
example:
message: The given data was invalid.
errors: {}
statusCode: 422
required:
- errors
- statusCode
x-examples:
Multiple fields Error:
message: The given data was invalid.
errors:
messages:
- The number you want to send the message to is not on whatsapp.
jid: 20121323124131@s.whatsapp.net
exists: false
statusCode: 422
'Single Field error ':
message: The given data was invalid.
errors:
messages:
- textMessage.text should not be empty
statusCode: 422
x-stoplight:
id: 90x3wfxw7gqcb
ServerError:
type: object
title: ServerError
properties:
message:
type: string
example:
message: Internal Server Error
x-stoplight:
id: 2fhq2gihsfreh
securitySchemes:
Authorization:
type: http
scheme: bearer
````