Console

Send notification

.md

POST

https://whatsapp.paaltech.org/api/v1/businesses/{external_id}/notifications

Token ability: messages.send · Authentication

One notification, tried on channels in order (default whatsapp, sms, email) until one takes it. A channel is passed over when there is no content or address for it, the business has not set it up, its provider is unavailable, or the send is refused (opted out, suppressed...). If its message later fails, the next channel is tried. A message whose fate is unknown never triggers the next channel - it may already have arrived. Addresses come from to, or from the contact (contact_id). Same reference, same notification.

Path parameters

external_id string required

Your own ID for the business (Multi-SKUUL - the tenant ID).

Max 191 characters. Pattern ^[A-Za-z0-9._:-]+$.

Body parameters

channels array of strings

contact_id integer | null

to object | null

whatsapp string to.whatsapp

sms string to.sms

email string to.email

whatsapp object | null

template object whatsapp.template

Name, language and components - as on Send message.

sms object | null

text string sms.text

Max 918 characters.

email object | null

subject string email.subject

text string email.text

reference string | null

Max 150 characters.

category string | null

One of: marketing, notifications, transactional, ``.

topic string | null

urgent boolean

Responses

200

Duplicate reference - the original notification.

202

Accepted; on its first usable channel.

401

unauthenticated - missing, invalid, revoked or expired token

403

missing_ability, product_suspended or product_token_required

404

not_found - not yours, or does not exist

422

validation_failed - fields are invalid; see errors.

429

rate_limited - over 300 requests/minute for this product

Errors always look like {"error": {"code", "message"}} - see Errors and status codes.

Language

Credentials

Authorization Bearer $PAALCHAT_TOKEN

Request

cURL

curl --request POST \
  --url 'https://whatsapp.paaltech.org/api/v1/businesses/presec/notifications' \
  --header "Authorization: Bearer $PAALCHAT_TOKEN" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "contact_id": 41,
  "reference": "closing-2026-10-02",
  "whatsapp": {"template": {"name": "school_closing", "language": "en_US"}},
  "sms": {"text": "Presec: school closes at 1pm today."},
  "email": {"subject": "School closes early", "text": "School closes at 1pm today."}
}'

const response = await fetch('https://whatsapp.paaltech.org/api/v1/businesses/presec/notifications', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PAALCHAT_TOKEN}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contact_id": 41,
    "reference": "closing-2026-10-02",
    "whatsapp": {"template": {"name": "school_closing", "language": "en_US"}},
    "sms": {"text": "Presec: school closes at 1pm today."},
    "email": {"subject": "School closes early", "text": "School closes at 1pm today."}
  }),
});

const data = await response.json();
console.log(response.status, data);

use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('PAALCHAT_TOKEN'))
    ->acceptJson()
    ->post('https://whatsapp.paaltech.org/api/v1/businesses/presec/notifications', [
        'contact_id' => 41,
        'reference' => 'closing-2026-10-02',
        'whatsapp' => ['template' => ['name' => 'school_closing', 'language' => 'en_US']],
        'sms' => ['text' => 'Presec: school closes at 1pm today.'],
        'email' => ['subject' => 'School closes early', 'text' => 'School closes at 1pm today.'],
    ]);

$data = $response->json();

import os
import requests

response = requests.post(
    "https://whatsapp.paaltech.org/api/v1/businesses/presec/notifications",
    headers={"Authorization": f"Bearer {os.environ['PAALCHAT_TOKEN']}", "Accept": "application/json"},
    json={
        "contact_id": 41,
        "reference": "closing-2026-10-02",
        "whatsapp": {"template": {"name": "school_closing", "language": "en_US"}},
        "sms": {"text": "Presec: school closes at 1pm today."},
        "email": {"subject": "School closes early", "text": "School closes at 1pm today."},
    },
)

print(response.status_code, response.json())

require 'net/http'
require 'json'

uri = URI('https://whatsapp.paaltech.org/api/v1/businesses/presec/notifications')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = "Bearer #{ENV['PAALCHAT_TOKEN']}"
request['Accept'] = 'application/json'
request['Content-Type'] = 'application/json'
request.body = <<~JSON
  {
    "contact_id": 41,
    "reference": "closing-2026-10-02",
    "whatsapp": {"template": {"name": "school_closing", "language": "en_US"}},
    "sms": {"text": "Presec: school closes at 1pm today."},
    "email": {"subject": "School closes early", "text": "School closes at 1pm today."}
  }
JSON

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.code, JSON.parse(response.body)

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	req, err := http.NewRequest("POST", "https://whatsapp.paaltech.org/api/v1/businesses/presec/notifications", strings.NewReader(`{
  "contact_id": 41,
  "reference": "closing-2026-10-02",
  "whatsapp": {"template": {"name": "school_closing", "language": "en_US"}},
  "sms": {"text": "Presec: school closes at 1pm today."},
  "email": {"subject": "School closes early", "text": "School closes at 1pm today."}
}`))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("PAALCHAT_TOKEN"))
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(out))
}

Try it with a test key

Only sk_test_ keys: requests reach your sandbox businesses, never real ones. The key is not saved.

Test key

external_id

JSON body

Response

Response

{
  "error": {"code": "unauthenticated", "message": "A valid product token is required."}
}

{
  "error": {
    "code": "missing_ability",
    "message": "This token does not have the ability this request needs."
  }
}

{"error": {"code": "not_found", "message": "Business not found."}}

{
  "error": {
    "code": "validation_failed",
    "message": "The external id field format is invalid. (and 1 more error)"
  },
  "errors": {
    "external_id": ["The external id field format is invalid."],
    "name": ["The name field is required."]
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Slow down and retry after the Retry-After header."
  }
}