API documentation

// Node.js / Bun / Deno
const response = await fetch("https://api.plingpush.com/api/push", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    token: process.env.PLING_TOKEN,
    title: "Build failed",
    message: error.message,
    channel: "ci",
    priority: "high"
  })
});

const data = await response.json();
// { ok: true, id: "notif_..." }Copy

import requests

requests.post("https://api.plingpush.com/api/push", json={
    "token": os.environ["PLING_TOKEN"],
    "title": "Training complete",
    "message": f"Loss: {final_loss:.4f}",
    "channel": "ml",
    "priority": "normal"
})Copy

var request = URLRequest(
  url: URL(string: "https://api.plingpush.com/api/push")!)
request.httpMethod = "POST"
request.setValue("application/json",
  forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode([
  "token": "YOUR_TOKEN",
  "title": "Backup complete",
  "message": "2.4 GB archived",
  "channel": "backups"
])
let (data, _) = try await URLSession.shared.data(for: request)Copy

payload, _ := json.Marshal(map[string]string{
    "token":    os.Getenv("PLING_TOKEN"),
    "title":    "Deploy complete",
    "channel":  "deploys",
    "priority": "normal",
})
http.Post("https://api.plingpush.com/api/push",
    "application/json", bytes.NewReader(payload))Copy

# .github/workflows/deploy.yml
- name: Notify Pling
  if: always()
  run: |
    curl -X POST https://api.plingpush.com/api/push \
      -H "Content-Type: application/json" \
      -d '{
        "token": "${{ secrets.PLING_TOKEN }}",
        "title": "Deploy ${{ job.status }}",
        "message": "${{ github.repository }}@${{ github.sha }}",
        "channel": "deploys",
        "priority": "${{ job.status == 'failure' && 'high' || 'normal' }}"
      }'Copy

#!/bin/bash
# pling-notify.sh — save and chmod +x
TOKEN="${PLING_TOKEN}"
TITLE="${1:-Notification}"
MSG="${2:-}"
PRIORITY="${3:-normal}"
CHANNEL="${4:-}"

curl -s -X POST https://api.plingpush.com/api/push \
  -H "Content-Type: application/json" \
  -d "$(jq -n \
    --arg t "$TOKEN" --arg title "$TITLE" \
    --arg msg "$MSG" --arg p "$PRIORITY" \
    --arg ch "$CHANNEL" \
    '{token:$t,title:$title,message:$msg,priority:$p,channel:$ch}')"

# Usage: ./pling-notify.sh "Deploy OK" "v2.4.1" "normal" "deploys"Copy

# Crontab heartbeat every 6 hours
0 */6 * * * curl -s -o /dev/null \
  "https://api.plingpush.com/api/push/YOUR_TOKEN?title=Heartbeat&m=Server+is+alive"

# Docker healthcheck
HEALTHCHECK --interval=5m CMD curl -sf \
  "https://api.plingpush.com/api/push/YOUR_TOKEN?t=Health+OK" || exit 1Copy