REST API + Webhooks

Build on
Friday Numbers

Pull your team's accountability data into your CRM, dashboards, or internal tools with our REST API and real-time webhooks.

Quick Start

Up and running in minutes

1

Create an API key

Go to Settings → API Keys in your dashboard and generate a key.

2

Make a request

Include your key in the X-API-Key header on every request.

3

Set up webhooks

Register an endpoint URL in Settings → Webhooks to receive events.

Terminal
# Fetch this week's team results
curl -H "X-API-Key: fn_live_abc123..." \
  https://acme.fridaynumbers.com/api/external/reviews?status=OPEN

# Response
{
  "reviews": [
    {
      "id": "rev_abc123",
      "weekLabel": "Mar 10 – Mar 14",
      "status": "OPEN",
      "responsesCount": 8
    }
  ]
}

API Reference

Endpoints

All endpoints require an API key via the X-API-Key header.

GET/api/external/reviews

List all weekly reviews with status and dates

GET/api/external/reviews/:id

Get a single review with all responses

GET/api/external/responses

List responses, filterable by agent or week

GET/api/external/team

List all team members with roles and goals

GET/api/external/team/:id

Get a single team member with stats and streaks

Full API documentation is available in your dashboard under Settings → API Docs.

Real-Time

Webhook Events

Get notified instantly when your team submits check-ins. We'll POST a JSON payload to your endpoint.

review.started

A new weekly review has been opened for submissions

review.closed

A weekly review has been closed by a coordinator

response.submitted

An agent has submitted their weekly check-in

response.updated

An agent has updated an existing response

Authentication

Every API request must include your API key in the X-API-Key header.

API keys are scoped to a single organization and can be created by team owners in the dashboard.

Keys prefixed with fn_live_ are production keys. Keep them secret.

Rate Limits

The API is rate-limited to 100 requests per minute per API key.

Rate limit headers are included in every response:

X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset

Ready to integrate?

Sign up, create an API key, and start pulling data in minutes. API access is available on the Business plan.