# Pocket Alert Docs

> Documentation for the Pocket Alert REST API at https://api.pocketalert.app: send push notifications to iOS and Android with one HTTP request, receive webhooks from other services, and manage applications, devices, webhooks and forms.

Most endpoints take an API key in the `Token` header; each page states the authentication it needs. Request bodies are JSON (`Content-Type: application/json`) or `multipart/form-data`. Every link below is the markdown version of a docs page, and all pages are in one file at https://info.pocketalert.app/llms-full.txt. For the product itself (pricing, use cases, comparisons), see https://pocketalert.app/llms.txt.

## Getting Started

- [Introduction](https://info.pocketalert.app/intro.md): Welcome to the API documentation for Pocket Alert. This document provides a comprehensive overview of the capabilities of our API, ensuring a smooth…
- [Quick Start](https://info.pocketalert.app/getting-started.md): Get started with PocketAlert in minutes. This guide walks you through sending your first push notification.
- [About](https://info.pocketalert.app/about.md): Pocket Alert serves as a robust platform dedicated to the dispatch of error notices, alerts, and informational messages. It's crafted to streamline the…

## Features

- [Priority Levels & Critical Alerts](https://info.pocketalert.app/features/priority-levels.md): Every Pocket Alert message carries a priority level that decides how loudly it lands: silently in the tray, as a normal banner, or as a critical alert that…
- [Action Buttons](https://info.pocketalert.app/features/action-buttons.md): A notification can carry up to three buttons. Instead of reading an alert and then opening a laptop to do something about it, you act from the lock screen:…
- [Scheduled Delivery](https://info.pocketalert.app/features/scheduled-delivery.md): Send a message now, have it arrive later. Add send_at or delay to any Create Message request and Pocket Alert stores it encrypted until the delivery time,…
- [Forms](https://info.pocketalert.app/features/forms.md): A form you build in the dashboard, publish at its own link, and embed anywhere. Every submission arrives as a push notification on your phone — the same…
- [Daily Message Limits](https://info.pocketalert.app/features/daily-limits.md): Every plan comes with a number of messages per day. The count resets at **00:00 UTC**. Once you reach the limit, new messages are rejected with 429 Too Many…
- [Two-Factor Authentication](https://info.pocketalert.app/features/two-factor-auth.md): Pocket Alert supports TOTP two-factor authentication on both the web dashboard and the mobile app. Once enabled, a password alone no longer gets anyone into…

## Tools

- [SDKs](https://info.pocketalert.app/sdks.md)
- [CLI](https://info.pocketalert.app/cli.md): Send push notifications from your terminal, scripts and CI, and manage Pocket Alert applications, devices, webhooks and API keys. Source code and releases:…
- [Browser Extension](https://info.pocketalert.app/browser-extension.md): The Pocket Alert extension puts your notification inbox in the browser toolbar — unread badge, desktop notifications, and a compose box for sending a push…
- [MCP Server](https://info.pocketalert.app/mcp.md): Pocket Alert speaks the Model Context Protocol, so an AI agent can send you push notifications, read your message history and check delivery stats as…

## API Reference: User

- [Login](https://info.pocketalert.app/api/user/login.md): Authenticate with email and password to obtain a JWT token.

## API Reference: Applications

- [Get Applications](https://info.pocketalert.app/api/applications/get-applications.md): Retrieve a list of all applications in your account.
- [Get Application](https://info.pocketalert.app/api/applications/get-application.md): Retrieve details of a specific application by its unique identifier.
- [Create](https://info.pocketalert.app/api/applications/create.md): Create a new application to organize and categorize your messages.
- [Update](https://info.pocketalert.app/api/applications/update.md): Update an existing application's details.
- [Delete](https://info.pocketalert.app/api/applications/delete.md): Permanently delete an application and all its associated messages and webhooks. This action cannot be undone.

## API Reference: Devices

- [Get Devices](https://info.pocketalert.app/api/devices/get-devices.md): Retrieve a list of all devices registered to your account.
- [Get Device](https://info.pocketalert.app/api/devices/get-device.md): Retrieve details of a specific device by its unique identifier.
- [Update](https://info.pocketalert.app/api/devices/update.md): Update a device's name or settings.
- [Delete](https://info.pocketalert.app/api/devices/delete.md): Remove a device from your account. This action cannot be undone.

## API Reference: Messages

- [Get Messages](https://info.pocketalert.app/api/messages/get-messages.md): Retrieve a list of all messages in your account.
- [Get Message](https://info.pocketalert.app/api/messages/get-message.md): Retrieve details of a specific message by its unique identifier.
- [Create](https://info.pocketalert.app/api/messages/create.md): Send a push notification to your devices.
- [Create with Attachment](https://info.pocketalert.app/api/messages/create-attach-file.md): Send a push notification with an attached image file.
- [Update](https://info.pocketalert.app/api/messages/update.md): Update an existing message's content or read status.
- [Delete](https://info.pocketalert.app/api/messages/delete.md): Permanently delete a message. This action cannot be undone.
- [Statistics](https://info.pocketalert.app/api/messages/stat.md): Get message count statistics grouped by date.
- [Usage](https://info.pocketalert.app/api/messages/usage.md): Get today's message usage against your plan's daily limit.

## API Reference: Webhooks

- [Get Webhooks](https://info.pocketalert.app/api/webhooks/get-webhooks.md): Retrieve a list of all webhooks configured in your account.
- [Get Webhook](https://info.pocketalert.app/api/webhooks/get-webhook.md): Retrieve details of a specific webhook by its unique identifier.
- [History](https://info.pocketalert.app/api/webhooks/history.md): Retrieve the history of incoming requests to a specific webhook — what was sent, what was rendered, and whether an alert was delivered.
- [Create](https://info.pocketalert.app/api/webhooks/create.md): Create a new webhook to receive notifications from external services.
- [Update](https://info.pocketalert.app/api/webhooks/update.md): Update a webhook's name, message template, or activity status.
- [Delete](https://info.pocketalert.app/api/webhooks/delete.md): Permanently delete a webhook. This action cannot be undone.
- [Settings](https://info.pocketalert.app/api/webhooks/settings.md): Learn how to configure webhook message templates to extract data from incoming JSON payloads.

## API Reference: Forms

- [Get Forms](https://info.pocketalert.app/api/forms/get-forms.md): Retrieve every form in your account, newest first.
- [Create](https://info.pocketalert.app/api/forms/create.md): Create a hosted form. It is published immediately at https://frms.click/{tid}, and every submission becomes a message on your account — see Forms.
- [Update](https://info.pocketalert.app/api/forms/update.md): Replace a form's fields, design and settings. Every field is applied, so send the whole form, not a patch.
- [Delete](https://info.pocketalert.app/api/forms/delete.md): Permanently delete a form. Its public link stops working at once. Messages the form already produced are kept.
- [Get Public Form](https://info.pocketalert.app/api/forms/get-form.md): Read a live form the way a visitor's browser does: its fields and design, without anything private. **No authentication** — this is the endpoint the form…
- [Submit](https://info.pocketalert.app/api/forms/submit.md): Send a response. The submission becomes a message on the owner's account and is pushed to their phone — the same pipeline a webhook call goes through. **No…