A developer-first API to send and manage WhatsApp messages programmatically — no official Business account, no queue, no friction.
A focused API surface built for speed and simplicity. All core messaging operations in one place.
X-Api-Key header. Simple token-based security that works everywhere./api/status endpoint returns uptime, version, and server time. Monitor with any HTTP checker.All endpoints return JSON. Protected endpoints require the X-Api-Key header.
/api/status require X-Api-Key: your_api_key in the request header. Requests without a valid key return 401 Unauthorized.
Returns the current status of the API server including version, server time, and PHP version. This endpoint is public and requires no authentication — ideal for uptime monitoring.
| Auth required | No |
| Rate limited | No |
curl https://youmsg.in/api/status
{
"status": "success",
"app": "YouMsg",
"domain": "youmsg.in",
"version": "2.0.0",
"time": "2025-01-01T00:00:00+05:30",
"php": "8.3.0"
}
| to | string | required | Recipient phone number with country code. E.g. 919876543210 |
| message | string | required | Message content — plain text or a URL for image/document types. |
| type | string | optional | Message type. One of text, image, document. Defaults to text. |
curl -X POST https://youmsg.in/api/send \ -H "Content-Type: application/json" \ -H "X-Api-Key: your_api_key" \ -d '{ "to": "919876543210", "message": "Hello from YouMsg!", "type": "text" }'
{
"status": "success",
"message": "Message queued successfully.",
"data": {
"id": "msg_abc123",
"to": "919876543210",
"message": "Hello from YouMsg!",
"type": "text",
"status": "sent",
"timestamp": "2025-01-01T00:00:00+05:30"
}
}
| to | string | optional | Filter messages by recipient phone number. Returns only messages sent to that number. |
curl https://youmsg.in/api/messages \ -H "X-Api-Key: your_api_key" # Filter by recipient curl "https://youmsg.in/api/messages?to=919876543210" \ -H "X-Api-Key: your_api_key"
{
"status": "success",
"total": 42,
"data": [ /* array of message objects */ ]
}
| id | string | required | The unique message ID returned when the message was sent. E.g. msg_abc123 |
curl -X DELETE \ https://youmsg.in/api/messages/msg_abc123 \ -H "X-Api-Key: your_api_key"
{
"status": "success",
"message": "Message deleted."
}
{
"status": "error",
"message": "Message not found."
}
| phone | string | required | Phone number with country code to register as a session. |
| name | string | optional | A human-readable label for this session. Defaults to Unnamed. |
curl -X POST https://youmsg.in/api/session \ -H "Content-Type: application/json" \ -H "X-Api-Key: your_api_key" \ -d '{ "phone": "919876543210", "name": "My Business" }'
{
"status": "success",
"message": "Session created.",
"data": {
"id": "sess_abc123",
"phone": "919876543210",
"name": "My Business",
"status": "active",
"created_at": "2025-01-01T00:00:00+05:30"
}
}
Returns all registered sessions with their IDs, names, phone numbers, and statuses. Useful for verifying which sessions are active before sending.
curl https://youmsg.in/api/sessions \
-H "X-Api-Key: your_api_key"
{
"status": "success",
"total": 3,
"data": [ /* array of session objects */ ]
}
| id | string | required | The session ID returned when the session was created. E.g. sess_abc123 |
curl -X DELETE \ https://youmsg.in/api/session/sess_abc123 \ -H "X-Api-Key: your_api_key"
{
"status": "success",
"message": "Session deleted."
}
All plans include core API access. Upgrade anytime as your messaging volume grows.
* Prices are exclusive of taxes. All plans auto-renew monthly. Cancel anytime.
Deploy the single PHP file, set your API key, and make your first call. No signup, no dashboard, no waiting.