API Reference

Authentication

All API requests must include your API key in the Authorization header. Generate your API key from Settings → Developer → API Keys.

curl https://app.vervepulse.io/api/v1/members \
  -H "Authorization: Bearer vp_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Keep your API key secret. Do not expose it in client-side code or public repositories. Rotate compromised keys immediately from Settings → Developer.

Endpoints

Webhooks

VERVE Pulse sends webhook events to your endpoint when key actions occur. Configure webhook URLs in Settings → Developer → Webhooks.

// Example webhook payload
{
  "event": "member.created",
  "timestamp": "2026-03-18T06:00:00Z",
  "gym_id": "gym_xxxxxxxxxxxx",
  "data": {
    "id": "mem_xxxxxxxxxxxx",
    "name": "Alex Johnson",
    "email": "alex@example.com",
    "membership_type": "Growth",
    "created_at": "2026-03-18T06:00:00Z"
  }
}

Rate Limits & Errors

The API allows 1,000 requests per hour per API key. If you exceed this, you will receive a 429 Too Many Requests response. The Retry-After header indicates when you can retry.