Skip to main content
GoodMarksGoodMarks
Built to comply with FTC + Google

Docs

Build on GoodMarks

The GoodMarks platform is API-first. Everything the dashboard does, you can do from your own app, Zapier, n8n, Make, or a custom integration.

API reference (v1)

REST + JSON. API keys with scopes, cursor pagination, idempotency keys, request IDs. Full reference for every endpoint.

Read →

Webhooks

Stripe-style HMAC SHA-256 signed payloads. Subscribe to rating, public-click, private-feedback, and review-request events.

Read →

API keys & scopes

Mint scoped, organization-bound keys. Create from the dashboard or POST /v1/api-keys. Plaintext returned exactly once.

Read →

Zapier / Make / n8n

Slim dropdown endpoints, /v1/me for auth tests, idempotency keys on review-request creates so retries are safe.

Read →

Delight

Send digital eGift cards or physical treats, auto on a 5-star signal or manually from any review. Setup, billing, compliance.

Read →

Base URL

https://goodmarks.io/api/v1

All requests need an Authorization: Bearer sr_… header (API key) or a session cookie (first-party dashboard). Public route endpoints under /v1/public/* are unauthenticated and rate-limited.