A curl push notification tells you when a long site script finishes
Append one POST to /ping/@username at the end of a sitemap check, REST audit or build step.
·3 min read
A curl push notification lets an automated script ping your phone the moment a long audit, crawl or site check wraps up. Instead of leaving a terminal tab open while a script polls an API or scans pages, you append one curl command at the end of the pipeline and walk away.
Where SEO and site automation scripts lose time
Technical checks rarely fail cleanly at second one. You might script a nightly sitemap check, run an automated check against seogeoaeo.ai over REST with a workspace API key, or wait on a static site build after a big content push. When the job breaks silently at step four, nobody notices until the next morning.
Sending one HTTP POST with AyePing closes that gap without adding a webhook server:
curl https://ayeping.com/ping/@you \
-H "Authorization: Bearer $AYEPING_TOKEN" \
-d '{"title":"Audit script failed","message":"Check **sitemap** job on prod-runner.","label":{"text":"seo","color":"red"}}'
Notice /ping/@you in the path: AyePing supports both /@username and /ping/@username for tools or proxies that balk at a leading @.
Payload limits and color labels for quick triage
Label colors help when one phone receives alerts from builds, uptime checks and indexing scripts:
| Label color options | Purpose in a script | Size limit |
|---|---|---|
red, orange |
Broken status codes or failed job exit | Title: 100 chars, single line |
yellow, blue |
Threshold warnings or queued runs | Message: 2,000 chars Markdown |
green, teal |
Rare completed batch milestones | Body total: 32 KB max |
If a script accidentally dumps an entire HTML page into -d, AyePing rejects payloads over 32 KB with HTTP 413 (body_too_large), protecting both your phone and your quota.
Protecting scripts from double charges and leaky secrets
Two details matter when curl runs inside CI or scheduled runners. First, always store $AYEPING_TOKEN in an environment secret rather than committing it to a repository; each token can only message its own owner, and a compromised token can be paused on the Tokens page (403 token_paused) without affecting other scripts. Second, pass Idempotency-Key (up to 255 characters) when your runner retries failed network steps, so the relay returns the first ping's id instead of delivering twice.
Pricing and limits as of November 2026
AyePing's Free plan gives 5 trial pings and 3 tokens with no card and 90-day retention. Hobby is $8 monthly or $49 yearly ($4.08 a month) for 120,000 pings and 25 tokens, while Pro is $20 monthly or $120 yearly ($10 a month) for 1,200,000 pings and 100 tokens, with 1-year retention and no rollover of unused pings.
Each token also defaults to 60 requests an hour (tunable from 1 to 3,600) and returns RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers so your wrapper knows how much headroom remains.
When curl is not enough
A personal curl ping goes to one account owner. If an entire marketing or engineering team needs alerts when an agency client's site drops out of an index, use a shared team channel or monitor instead of sharing one person's phone token.
FAQ
Why does AyePing support /ping/@username as well as /@username?
Some HTTP tools, proxies or shell wrappers treat a leading @ character in a URL path specially. Adding /ping before /@username avoids that parser conflict.
What happens if my curl payload has a newline inside the title?
AyePing requires title to be 1 to 100 characters on a single line. A newline triggers HTTP 400 (invalid_body), with a message naming the offending field.
Can links inside a curl push notification open automatically?
No. AyePing's documentation notes that links prompt before opening, and Markdown images are not loaded, preventing tracking pixels.