Reference

Payloads that make useful alerts.

Only the website project is available in this workspace, so these examples are generic. Use the webhook URL copied from your PINGSLAP Space.

Headers

For JSON payloads, send Content-Type: application/json. If your tool offers a request method, choose POST. After your request is saved in the source system, use Verify Integration.

Minimal JSON

{
  "title": "New alert",
  "message": "Something important happened"
}

Lead example

{
  "title": "New website lead",
  "message": "Taylor Reed wants a roof quote",
  "name": "Taylor Reed",
  "email": "taylor@example.com",
  "source": "Contact page"
}

Nested payload

{
  "title": "Checkout issue",
  "message": "Payment retry failed",
  "customer": {
    "name": "Jordan Lee",
    "plan": "Pro"
  },
  "meta": {
    "severity": "high",
    "orderId": "A1042"
  }
}

Best practices

Send a short title.
Put the human action in the message.
Include an ID or source for debugging.
Avoid passwords, card data, and private health or legal details.

curl

curl -X POST "https://api.pingslap.com/webhook/YOUR_SPACE" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "New website lead",
    "message": "Taylor wants a quote today"
  }'

fetch

await fetch("https://api.pingslap.com/webhook/YOUR_SPACE", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "New website lead",
    message: "Taylor wants a quote today"
  })
});

Browser JavaScript may be blocked by CORS even when curl works. See JavaScript and CORS.

Expected responses

Status	Meaning
2xx	The request was accepted by the webhook endpoint.
400 or 422	The URL or payload may be invalid.
401, 403, or 404	The webhook URL may be wrong, expired, or not allowed.
429	Too many requests in a short time. Slow down and retry later.
5xx	The receiving service had a temporary problem. Retry after a delay.

A successful status code only tells you the request was accepted. Use the verification checklist to confirm the alert appears correctly on your phone.