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.

bash
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.

bash
npm install selfping

Get 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.

bash
npx selfping login
npx selfping run -- npm test

Check service status at GET /api/health.

Agent integrations

Machine-readable indexes

Auth