Send WhatsApp Message

Send a text or template message to a WhatsApp contact.

UTILITY / MARKETING

POST /whatsapp/send-whatsapp-message/

Headers

Name	Value
Authorization	Bearer Access Token
Content-Type	application/json

Payload

phone_number required	string Recipient phone number in E.164 format
message required	string Message text or template data with variables replaced with actual values
sender_number required	string Sender WhatsApp number (number registered with WhatsApp Business)
type	string Default: "text" Enum: "text" "template" Message type text - text template - template
	object Template data (required if type is 'template')

Response

{
 "message": "Message sent successfully",
 "data": {
  "id": 1,
  "message": "Hello World",
  "message_id": "wamid.XXXXX",
  "status": "<status (SENT/RECEIVED)>",
  "contact": "<contact_id>",
  "phone_number_id": "<phone_number_id>",
  "created_at": "<timestamp>"
 },
 "success": true
}

AUTHENTICATION

Send authentication template messages for OTP codes and verification purposes.

POST /whatsapp/send-whatsapp-message/

Headers

Name	Value
Authorization	Bearer Access Token
Content-Type	application/json

Payload

phone_number required	string Recipient phone number in E.164 format (e.g., 919876543210)
message required	string Message you want to store from your side. This message will show in API responses and FreJun WhatsApp Dashboard
sender_number required	string Sender WhatsApp number (Virtual Number in E.164 format)
type	string Default: "template" Value: "template" Message type (must be 'template' for authentication templates) template - template
required	object Template data for AUTHENTICATION templates (OTP, verification codes)

Response

{
 "message": "Message sent successfully",
 "data": {
  "id": "<Message ID in FreJun>",
  "message": "<OTP with default message from whatsapp>",
  "user_id": "<WhatsApp contact ID in FreJun>",
  "message_id": "<message ID in whatsapp E.g, wamid.XXXXXXXXXXXXXXXX>",
  "status": "QUEUED",
  "read_by_user": true,
  "created_at": "<timestamp E.g, 2026-02-18T16:48:22.369571>",
  "updated_at": "<timestamp E.g, 2026-02-18T16:48:22.369586>",
  "template": "<Associated template ID>",
  "phone_number_id": "<Associated phone number ID in FreJun>",
  "contact": "<Associated contact ID in FreJun>",
  "owner": {
   "id": "<User ID in FreJun>",
   "email": "<email of the frejun account used to send the message>",
   "name": "<Name in FreJun account>"
  }
 },
 "success": true
}