PewPrep API

Public API

Programmatic access to members, bulletins, and analytics. Available on the Enterprise plan. Keys are scoped, hashed at rest, and revocable from Settings → API.

Authentication

Send your API key as a bearer token on every request:

curl https://pewprep.com/api/v1/members \
  -H 'Authorization: Bearer pp_live_<your-key>'

Endpoints

Each endpoint requires a scope on the API key. Add scopes when creating the key. Rate limit: 600 requests per hour per key.

GET/api/v1/membersmembers:read

List members for the authenticated congregation. Supports `limit` and `offset`.

POST/api/v1/membersmembers:write

Create a member. Body: `{ email, first_name?, last_name?, member_group? }`.

GET/api/v1/bulletinsbulletins:read

List bulletin drafts for the authenticated congregation.

POST/api/v1/bulletins/generatebulletins:generate

Enqueue bulletin generation for a given `weekly_input_id`. Returns 202 with a poll URL.

GET/api/v1/analyticsanalytics:read

30-day analytics snapshot — active members, emails sent, SMS delivered, visitor signups.

Errors

  • 401 · Missing, invalid, expired, or revoked token.
  • 403 · Token does not have the required scope.
  • 429 · Rate limited. Standard X-RateLimit-* headers tell you when to retry.
  • 500 · Server error. Retry with exponential backoff.