WhatsApp Web

Send WhatsApp Message via WhatsApp Web

post

Send a WhatsApp message directly to a phone number via WhatsApp Web.

Key Features:

• Send to any phone number (E.164 format required, e.g., [phone])

• Automatic contact creation if contact doesn't exist

• Message chunking: Messages are automatically split by double newlines (\n\n) into separate WhatsApp messages

• Natural typing simulation: Delays between chunks simulate human typing speed (500 chars/min)

• Typing indicators: Shows "typing..." status during message sending

• Credit-based: 1 credit per message (regardless of number of chunks)

Requirements:

• Active WhatsApp Web connection required

• Phone number must be in E.164 format (e.g., [phone])

• Sufficient credits (1 credit per message)

Message Chunking Example:

Input message: "Hey Sohaib! 👋\n\nGreat news about your feature request!\n\nI'll let you know when it's live!"

Results in 3 separate WhatsApp messages:

1. Hey Sohaib! 👋

2. Great news about your feature request!

3. I'll let you know when it's live!

Note: This endpoint uses WhatsApp Web, not the Meta Business API, so no template approval is required.

Authorizations

ApiKeyAuthUserIdAuth

apiKeystringRequired

Your DM Champ API key. Obtain from Settings → API Keys.

Query parameters

apiKeystringOptional

API key for authentication. At least one of apiKey or userId is required for protected endpoints.

Example: your_api_key

Body

application/json

phoneNumberstringRequired

Recipient's phone number in E.164 format (e.g., [phone])

Example: [phone]Pattern: ^[+][1-9][0-9]{1,14}$

messagestringRequired

Message text. Will be automatically split by double newlines into separate messages.

Example: Hey Sohaib! 👋 Great news about your feature request! I'll let you know when it's live!

Responses

200

Message(s) sent successfully

application/json

successbooleanOptionalExample: true

contactIdstringOptional

ID of the contact (created or existing)

Example: contact123

messagesSentintegerOptional

Number of message chunks successfully sent

Example: 3

totalChunksintegerOptional

Total number of chunks the message was split into

Example: 3

messageIdsstring[]Optional

Array of message IDs for each sent chunk

Example: ["msg1","msg2","msg3"]

creditsUsedintegerOptional

Total credits deducted (always 1 per message, regardless of chunks)

Example: 1

400

Bad request - Invalid input

application/json

401

Unauthorized - Invalid API key

application/json

402

Payment required - Insufficient credits

application/json

500

Internal server error

application/json

post

/whatsapp-web/send

HTTPcURLJavaScriptPython

POST /v1/whatsapp-web/send HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "phoneNumber": "[phone]",
  "message": "Hello! This is a test message."
}

Send single messageSend chunked message (will split into 3 messages)

{
  "success": true,
  "contactId": "contact123",
  "messagesSent": 3,
  "totalChunks": 3,
  "messageIds": [
    "msg1",
    "msg2",
    "msg3"
  ],
  "creditsUsed": 1
}