نوتي فاير - Noti Fire API Documentation

Powerful WhatsApp messaging API for developers

REST API JSON HTTPS

Fast Delivery

Send thousands of messages in seconds with high delivery rates

Secure & Reliable

Enterprise-grade security with 99.9% uptime guarantee

Easy Integration

Simple REST API with comprehensive documentation

24/7 Support

Dedicated technical support team ready to help

Important Information

All requests must be made over HTTPS
Request and response format: JSON
Base API URL: https://noti-fire.com/api/
Rate limit: 60 requests per minute

Authentication

All API requests require a valid device ID. You can obtain your device ID from the dashboard after setting up your WhatsApp device.

Note: Keep your device ID secure and never share it publicly. Each device ID is unique to your WhatsApp connection.

Send Text Message

Send a text message to a specific WhatsApp number.

POST https://noti-fire.com/api/send/message

Parameters

Parameter	Type	Required	Description
`device_id`	string	Required	Your unique device identifier
`to`	string	Required	Phone number with country code (max: 20 characters)
`message`	string	Required	Text message content (max: 2000 characters)

Example Request

curl -X POST https://noti-fire.com/api/send/message \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "to": "+2010xxxxxxxx",
    "message": "Hello! This is a test message from نوتي فاير -  Noti Fire API"
}'

Send Bulk Messages

Send the same message to multiple recipients in a single request.

POST https://noti-fire.com/api/send/bulk/message

Parameters

Parameter	Type	Required	Description
`device_id`	string	Required	Your unique device identifier
`message`	string	Required	Text message content (max: 2000 characters)
`numbers`	array	Required	Array of phone numbers (max: 20 numbers)

Example Request

curl -X POST https://noti-fire.com/api/send/bulk/message \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "message": "Hello! This is a bulk message",
    "numbers": ["+2010xxxxxxxx", "+201111111111", "+201222222222"]
}'

Send Media (URL)

Send media files (images, videos, audio, PDFs) using a URL.

POST https://noti-fire.com/api/send/media

Parameters

Parameter	Type	Required	Description
`device_id`	string	Required	Your unique device identifier
`to`	string	Required	Phone number with country code (max: 20 characters)
`type`	string	Required	Media type: image, video, audio, pdf
`mediaUrl`	string	Required	URL of the media file (max: 1000 characters)
`caption`	string	Optional	Caption for image/video/pdf (max: 2000 characters)
`isVoiceNote`	boolean	Audio only	Send audio as voice note (true/false)
`fileName`	string	PDF only	Custom filename for PDF (max: 100 characters)

Example Request - Image

curl -X POST https://noti-fire.com/api/send/media \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "to": "+2010xxxxxxxx",
    "type": "image",
    "mediaUrl": "https://example.com/image.jpg",
    "caption": "Beautiful sunset!"
}'

Example Request - Video

curl -X POST https://noti-fire.com/api/send/media \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "to": "+2010xxxxxxxx",
    "type": "video",
    "mediaUrl": "https://example.com/video.mp4",
    "caption": "Beautiful sunset!"
}'

Example Request - Audio

curl -X POST https://noti-fire.com/api/send/media \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "to": "+2010xxxxxxxx",
    "type": "audio",
    "mediaUrl": "https://example.com/audio.mp3",
    "isVoiceNote": true
}'

Example Request - PDF

curl -X POST https://noti-fire.com/api/send/media \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "to": "+2010xxxxxxxx",
    "type": "pdf",
    "mediaUrl": "https://example.com/doc.pdf",
    "fileName": "invoce-123.pdf",
    "caption": "caption",
}'

Send Media (File Upload)

Upload and send media files directly from your server.

POST https://noti-fire.com/api/send/media/file

File Requirements:

Supported formats: JPEG, PNG, JPG, GIF, MP4, MOV, AVI, MKV, MP3, WAV, PDF
Maximum file size: 10MB
Use multipart/form-data for file uploads

Parameters

Parameter	Type	Required	Description
`device_id`	string	Required	Your unique device identifier
`to`	string	Required	Phone number with country code (max: 20 characters)
`type`	string	Required	Media type: image, video, audio, pdf
`file`	file	Required	The media file to upload (max: 10MB)
`caption`	string	Optional	Caption for image/video/pdf (max: 2000 characters)
`isVoiceNote`	boolean	Audio only	Send audio as voice note (true/false)
`fileName`	string	PDF only	Custom filename for PDF (max: 100 characters)

Example Request - Image

curl -X POST https://noti-fire.com/api/send/media/file \
    -H "Content-Type: multipart/form-data" \
    -F "device_id=test-123-456-789" \
    -F "to=+2010xxxxxxxx" \
    -F "type=image" \
    -F "file=@/path/to/image.png" \
    -F "caption=Uploaded image"

Example Request - Video

curl -X POST https://noti-fire.com/api/send/media/file \
    -H "Content-Type: multipart/form-data" \
    -F "device_id=test-123-456-789" \
    -F "to=+2010xxxxxxxx" \
    -F "type=video" \
    -F "file=@/path/to/video.mp4" \
    -F "caption=Uploaded video"

Example Request - Audio

curl -X POST https://noti-fire.com/api/send/media/file \
    -H "Content-Type: multipart/form-data" \
    -F "device_id=test-123-456-789" \
    -F "to=+2010xxxxxxxx" \
    -F "type=audio" \
    -F "file=@/path/to/audio.mp3" \
    -F "isVoiceNote=true"

Example Request - PDF

curl -X POST https://noti-fire.com/api/send/media/file \
    -H "Content-Type: multipart/form-data" \
    -F "device_id=test-123-456-789" \
    -F "to=+2010xxxxxxxx" \
    -F "type=pdf" \
    -F "file=@/path/to/document.pdf" \
    -F "fileName=invoice-123.pdf" \
    -F "caption=Invoice document"

Send Contact

Share contact information as a vCard.

POST https://noti-fire.com/api/send/contact

Parameters

Parameter	Type	Required	Description
`device_id`	string	Required	Your unique device identifier
`to`	string	Required	Recipient phone number (max: 20 characters)
`contact_name`	string	Required	Contact's name (max: 25 characters)
`contact_phone`	string	Required	Contact's phone number (max: 20 characters)

Example Request

curl -X POST https://noti-fire.com/api/send/contact \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "to": "+2010xxxxxxxx",
    "contact_name": "John Doe",
    "contact_phone": "+201111111111"
}'

Send Location

Share geographical coordinates as a location pin.

POST https://noti-fire.com/api/send/location

Parameters

Parameter	Type	Required	Description
`device_id`	string	Required	Your unique device identifier
`to`	string	Required	Recipient phone number (max: 20 characters)
`latitude`	numeric	Required	Latitude coordinate (range: -90 to 90)
`longitude`	numeric	Required	Longitude coordinate (range: -180 to 180)

Example Request

curl -X POST https://noti-fire.com/api/send/location \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "to": "+2010xxxxxxxx",
    "latitude": "30.4589847",
    "longitude": "31.1472218"
}'

Send Group Messages

Send various types of messages to WhatsApp groups.

POST https://noti-fire.com/api/group/send/message

Base Parameters

Parameter	Type	Required	Description
`device_id`	string	Required	Your unique device identifier
`group_id`	string	Required	WhatsApp group ID (max: 50 characters)
`type`	string	Required	Message type: text, image, video, audio, document, contact, location

Type-specific Parameters

Text Message

curl -X POST https://noti-fire.com/api/group/send/message \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "group_id": "[email protected]",
    "type": "text",
    "text": "Hello group members!"
}'

Image/Video Message

curl -X POST https://noti-fire.com/api/group/send/message \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "group_id": "[email protected]",
    "type": "image",
    "url": "https://example.com/image.jpg",
    "caption": "Check out this image!"
}'

Audio Message

curl -X POST https://noti-fire.com/api/group/send/message \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "group_id": "[email protected]",
    "type": "audio",
    "url": "https://example.com/audio.mp3",
    "ptt": true
}'

Contact Message

curl -X POST https://noti-fire.com/api/group/send/message \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "group_id": "[email protected]",
    "type": "contact",
    "name": "John Doe",
    "phoneNumber": "+2010xxxxxxxx"
}'

Location Message

curl -X POST https://noti-fire.com/api/group/send/message \
-H "Content-Type: application/json" \
-d '{
    "device_id": "test-123-456-789",
    "group_id": "[email protected]",
    "type": "location",
    "latitude": "31.1472218",
    "longitude": "30.4589847"
}'

Error Codes

Understanding API error responses and how to handle them.

Status Code	Error Type	Description	Solution
`400`	Bad Request	Invalid request parameters	Check your request format and required fields
`401`	Unauthorized	Invalid or missing device ID	Verify your device ID is correct
`403`	Forbidden	Device not connected or suspended	Check device status in dashboard
`429`	Too Many Requests	Rate limit exceeded	Slow down your requests
`500`	Internal Server Error	Server-side error	Contact support if persistent

Rate Limits

API usage limits and best practices.

60 requests per minute
Unlimited messages
Max 20 numbers per bulk request
Max 2000 characters per message

Need Help?

Our technical support team is here to help you integrate successfully.

WhatsApp Support Email Support

Response time: Usually within 2 hours