Quick Start

Get started with PocketAlert in minutes. This guide walks you through sending your first push notification.

Prerequisites

• A PocketAlert account — Sign up or Sign in
• The PocketAlert mobile app installed on your device

---

Step 1: Get Your API Key

1. Log in to PocketAlert
2. Navigate to API Keys
3. Click Create New Key
4. Copy and save your API key securely

Important

Your API key is shown only once. Store it in a safe place.

---

Step 2: Send Your First Notification

Choose your preferred method:

cURL

curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Hello from API",
    "message": "This is my first notification!"
  }'

JavaScript

const response = await fetch('https://api.pocketalert.app/v1/messages', {
  method: 'POST',
  headers: {
    'Token': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'Hello from API',
    message: 'This is my first notification!'
  })
});

const data = await response.json();
console.log('Message sent:', data.tid);

Python

import requests

response = requests.post(
    'https://api.pocketalert.app/v1/messages',
    headers={
        'Token': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'title': 'Hello from API',
        'message': 'This is my first notification!'
    }
)

print('Message sent:', response.json()['tid'])

PHP

$response = Http::withHeaders([
    'Token' => 'YOUR_API_KEY',
])->post('https://api.pocketalert.app/v1/messages', [
    'title' => 'Hello from API',
    'message' => 'This is my first notification!',
]);

echo 'Message sent: ' . $response['tid'];

Go

package main

import (
    "bytes"
    "encoding/json"
    "net/http"
)

func main() {
    payload := map[string]string{
        "title":   "Hello from API",
        "message": "This is my first notification!",
    }
    body, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", 
        "https://api.pocketalert.app/v1/messages", 
        bytes.NewBuffer(body))
    req.Header.Set("Token", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    client.Do(req)
}

---

Step 3: Check the Response

A successful request returns:

{
  "tid": "cq4k7rml9m2qqmuw44ypoos93",
  "title": "Hello from API",
  "message": "This is my first notification!",
  "application": "",
  "device": "",
  "created_at": "18.01.2026 15:30:00"
}

Field	Description
tid	Unique message identifier
title	Your notification title
message	Your notification body
created_at	Timestamp when message was sent

---

What's Next?

Explore more features:

• Create Applications — Organize messages by project
• Manage Devices — Send to specific devices
• Set up Webhooks — Receive alerts from external services
• Use the CLI — Send notifications from your terminal

---

Need Help?

For further assistance or to share your use cases:

Resource	Link
Email Support	[email protected]
API Reference	Full Documentation
CLI Tool	Download & Install