SelfPing docs
SelfPing is an SMS-to-self API: one endpoint, one key, and texts can only go to the phone number that created the key. Start with a recipe, connect your agent, or go straight to the API.
Recipes
Step-by-step guides with code you can copy into your project.
Get a text when a new lead comes inNext.js contact form, interactive preview, server-side setup.Get a text when your Python cron job failsPython standard library, failure-only alerts, Linux cron setup.Replace email-to-text alerts in your scriptsStill emailing a carrier gateway to text yourself? Send the same alert to your own phone with one HTTP request. Includes Python and curl examples, with 10 free texts a month.Text yourself when a qualified lead arrives in n8nImport an n8n workflow that checks saved-lead events, skips unqualified and previously seen leads, and texts your own phone. Start with 10 free texts a month.Get an SMS when your GitHub Actions deploy failsAdd a failure-only SMS step to an existing GitHub Actions deployment job. Keep deployment status intact and send alerts to your own verified phone.Get a text when a new subscription paysAdd a short SMS alert after your Stripe webhook confirms and records a new subscription's first payment. Keep payment handling independent of notification delivery.Have your AI agent ask you a question by SMSConnect SelfPing over MCP, send a question to your own phone, and let your agent fetch your SMS reply with get_replies. Includes polling limits and ambiguous-reply handling.Browse runnable examples on GitHub for Python, deployment alerts, and application notifications.
The API
Send a text from your server. Replace the placeholder with your key. This sends a real text to your phone and uses one credit.
curl -X POST https://www.selfping.com/api/sms \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sp_your_api_key" \
-d '{"message": "Hello from my app."}'openapi.json has request and response shapes for every endpoint.
Use the npm package
selfping is one function with zero dependencies.
npm install selfpingGet a text when a command finishes
Log in once to save your key, then run any command through the CLI. The example below texts you when your tests finish and uses one credit.
npx selfping login
npx selfping run -- npm testCheck service status at GET /api/health.
Agent integrations
- Setup guide copy-paste config for Claude Code, Cursor and Codex
- MCP server at
https://www.selfping.com/api/mcpexposing thesend_pingtool - Completion hooks:
https://www.selfping.com/api/hooks/claude-code,/cursorand/codex - Agent skill when and how an agent should text its user
Machine-readable indexes
- llms.txt the short index, and llms-full.txt the complete reference in one fetch
- API catalog and MCP server card
- Every content page answers to
Accept: text/markdownor a.mdsuffix