Brixfit Developer API

curl -H "X-API-Key: brx_..." \
  "https://brixfit.app/api/public/v1/leads?page=1&per_page=20&status=new"

curl -X POST "https://brixfit.app/api/public/v1/leads" \
  -H "X-API-Key: brx_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Priya Sharma",
    "email": "[email protected]",
    "phone": "0091-9999999999",
    "weight": 78,
    "height": 162,
    "age": 28,
    "gender": "female",
    "activity_level": "moderate"
  }'

curl -H "X-API-Key: brx_..." "https://brixfit.app/api/public/v1/leads/lead-uuid-here"

curl -X PATCH "https://brixfit.app/api/public/v1/leads/lead-uuid-here" \
  -H "X-API-Key: brx_..." \
  -H "Content-Type: application/json" \
  -d '{ "status": "contacted", "phone": "+91-8888888888" }'

curl -X DELETE "https://brixfit.app/api/public/v1/leads/lead-uuid-here" -H "X-API-Key: brx_..."

curl -H "X-API-Key: brx_..." "https://brixfit.app/api/public/v1/fields/leads"

{
  "data": [
    { "field_key": "weight", "label": "Weight (kg)", "field_type": "number", "is_required": true  },
    { "field_key": "height", "label": "Height (cm)", "field_type": "number", "is_required": true  },
    { "field_key": "goal",   "label": "Goal",        "field_type": "string", "is_required": false },
    { "field_key": "age",    "label": "Age",         "field_type": "number", "is_required": false },
    { "field_key": "gender", "label": "Gender",      "field_type": "string", "is_required": false }
  ],
  "meta": null,
  "error": null
}

curl -H "X-API-Key: brx_..." "https://brixfit.app/api/public/v1/clients?status=active"

curl -H "X-API-Key: brx_..." "https://brixfit.app/api/public/v1/clients/client-uuid-here"

curl -X PATCH "https://brixfit.app/api/public/v1/clients/client-uuid-here" \
  -H "X-API-Key: brx_..." \
  -H "Content-Type: application/json" \
  -d '{ "account_status": "paused", "notes": "On vacation until April" }'

curl -X DELETE "https://brixfit.app/api/public/v1/clients/client-uuid-here" -H "X-API-Key: brx_..."

curl -H "X-API-Key: brx_..." \
  "https://brixfit.app/api/public/v1/checkins?from_date=2025-03-01&to_date=2025-03-31&status=completed"

curl -H "X-API-Key: brx_..." "https://brixfit.app/api/public/v1/clients/client-uuid-here/checkins"

curl -X POST "https://brixfit.app/api/public/v1/webhooks" \
  -H "X-API-Key: brx_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-n8n.example.com/webhook/brixfit",
    "events": ["lead.created", "lead.status_changed"],
    "description": "n8n lead pipeline"
  }'

import { createHmac } from 'crypto'

function verifyBrixfitWebhook(
  rawBody: string,
  signature: string,
  secret: string,
): boolean {
  const expected = 'sha256=' + createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex')
  return signature === expected
}

// Next.js App Router example
export async function POST(req: Request) {
  const rawBody = await req.text()
  const sig = req.headers.get('x-brixfit-signature') ?? ''
  if (!verifyBrixfitWebhook(rawBody, sig, process.env.BRIXFIT_WEBHOOK_SECRET!)) {
    return Response.json({ error: 'Invalid signature' }, { status: 401 })
  }
  const { event, data } = JSON.parse(rawBody)
  console.log('Event:', event, data)
  return Response.json({ ok: true })
}

curl -X PATCH "https://brixfit.app/api/public/v1/webhooks/webhook-uuid" \
  -H "X-API-Key: brx_..." \
  -H "Content-Type: application/json" \
  -d '{ "is_active": false }'

npm install @brixfit/sdk
# or: yarn add @brixfit/sdk  |  pnpm add @brixfit/sdk

import { BrixfitClient } from '@brixfit/sdk'

const brixfit = new BrixfitClient({ apiKey: 'brx_your_key_here' })

// List leads
const { data: leads, meta } = await brixfit.leads.list({
  per_page: 20,
  status: 'new',
})
console.log(`${meta.total} total leads`)

// Create a lead
const lead = await brixfit.leads.create({
  name: 'Priya Sharma',
  email: '[email protected]',
  goal: 'weight_loss',
  weight: 78,
})

// Update status
await brixfit.leads.updateStatus(lead.id, 'contacted')

// List clients
const { data: clients } = await brixfit.clients.list({ status: 'active' })

// Get check-ins for a client
const { data: checkins } = await brixfit.checkins.list({
  client_id: clients[0].id,
  from_date: '2025-03-01',
})

import { BrixfitClient, BrixfitAuthError, BrixfitValidationError, BrixfitRateLimitError } from '@brixfit/sdk'

try {
  const lead = await brixfit.leads.create({ name: '' })
} catch (err) {
  if (err instanceof BrixfitAuthError)            console.error('Check your API key')
  else if (err instanceof BrixfitValidationError) console.error('Fields:', err.details)
  else if (err instanceof BrixfitRateLimitError)  console.log('Wait:', err.retryAfter, 's')
}

n8n-nodes-brixfit

npm install n8n-nodes-brixfit

Method: POST
URL: https://brixfit.app/api/public/v1/leads
Header: X-API-Key = brx_your_key_here
Body (JSON):
{
  "name": "{{ $json.name }}",
  "email": "{{ $json.email }}",
  "phone": "{{ $json.phone }}"
}