API reference

Use the Clubhouse API to build custom integrations and automate loyalty operations.

The Clubhouse API lets you read and write loyalty data programmatically. It's a REST API that returns JSON.

Base URL

https://api.clubhouseapp.dk/v1

Authentication

All requests must include your API key as a Bearer token in the Authorization header.

bash

curl https://api.clubhouseapp.dk/v1/members/customer@example.com \
  -H "Authorization: Bearer YOUR_API_KEY"

You can find and manage your API keys in Settings → Integrations → API.

Rate limits

Requests are limited to 60 per minute per API key.

Endpoints

GET /members/:email

Returns a member's loyalty data by email address.

bash

curl https://api.clubhouseapp.dk/v1/members/customer@example.com \
  -H "Authorization: Bearer YOUR_API_KEY"

json

{
  "email": "customer@example.com",
  "name": "Emma Jensen",
  "points_balance": 340,
  "lifetime_points": 2150,
  "tier": "Gold",
  "tier_points_needed": 850,
  "created_at": "2024-03-01T12:00:00Z",
  "last_order_at": "2024-11-15T09:30:00Z"
}

POST /members/:email/points

Add or remove points from a member's balance.

bash

curl -X POST https://api.clubhouseapp.dk/v1/members/customer@example.com/points \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 100, "note": "Bonus points for referral"}'

Error codes

Code	Meaning
401	Unauthorized — invalid or missing API key
404	Member not found
422	Validation error — check your request body
429	Rate limit exceeded — slow down requests
500	Server error — contact support if this persists

Webhooks

Was this article helpful?

Send feedback →