API Reference

Welcome to the Nosr API documentation. Our API allows you to build powerful WhatsApp integration into your own applications. It is organized around REST, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.

api.nosr.com

HTTPS Only

Authentication

The Nosr API uses API tokens to authenticate requests. You can view and manage your API tokens in the Dashboard under Settings. Your API tokens carry many privileges, so be sure to keep them secure. Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, etc.

# Authorization Header Format

Authorization:Bearerns_live_832948...

Send Message

POST/messages

Sends a message to a destination phone number. Authentication is required.

Body Parameters

tostringREQUIRED
The destination phone number in E.164 format (e.g., +15555555555).
typestringREQUIRED
The type of message. Currently supports 'text', 'image', 'document'.
textobject
The text object. Required if type is 'text'.
preview_urlboolean
Whether to generate a preview for links in the message.

BASH

curl -X POST https://api.nosr.com/v1/messages \

-H "Authorization: Bearer TOKEN" \

-H "Content-Type: application/json" \

-d '{ "to": "+1234567890", "type": "text", "text": { "body": "Your order #1234 has shipped! 📦" } }'