Description

n8n-nodes-brixfit

—

What is Brixfit?

Brixfit is an AI-powered coaching CRM built for fitness and health coaches. It manages leads, clients, check-ins, workout plans, diet plans, progress photos, and automated health reports — all in one place.

This node lets you connect Brixfit to any tool in your n8n workflow.

—

Nodes Included

| Node | Type | Description |
|——|——|————-|
| Brixfit | Action | Perform operations on leads, clients, check-ins and webhooks |
| Brixfit Trigger | Trigger | Start workflows automatically when events fire in Brixfit |

—

Prerequisites

• A Brixfit account (coach plan)
• An API key — generate one at Brixfit → Developer → API Keys
• n8n v1.0.0 or later

—

Installation

n8n Cloud / Self-hosted UI (recommended)

1. Go to Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-brixfit
4. Click Install and confirm

Self-hosted (manual)

Navigate to your n8n installation
cd /usr/local/lib/node_modules/n8n
Install the package
npm install n8n-nodes-brixfit
Restart n8n

—

Setup

1. Add Brixfit credentials

In n8n, go to Credentials → New and search for Brixfit API.

| Field | Value |
|——-|——-|
| API Key | Your key from Brixfit → Developer → API Keys |
| Base URL | https://brixfit.app (leave as default) |

Click Save — n8n automatically tests the connection with a live API call and confirms your key is valid before saving.

2. Add the Brixfit node to a workflow

Drag the Brixfit node from the node panel and select your resource and operation.

3. Add the Brixfit Trigger (for event-driven workflows)

Drag Brixfit Trigger as the first node in your workflow:

1. Select the events you want to listen for
2. Activate the workflow — n8n automatically registers the webhook in Brixfit and stores the signing secret

That’s it — no manual copy-paste. When you deactivate the workflow, the webhook is automatically removed from Brixfit.

> Development note: Brixfit requires HTTPS webhook URLs. For local development use a tunnel such as ngrok to expose your n8n instance.

—

Operations

Lead

| Operation | Description |
|———–|————-|
| Get All | List leads with optional search, status filter, sort, and pagination. Enable Return All to auto-fetch every page. |
| Get | Fetch a single lead by ID |
| Create | Create a new lead — fields are dynamically loaded from your Brixfit account. Response includes plan-gated computed metrics (BMI, BMR, TDEE, body fat %). |
| Update | Update lead fields — same dynamic field loading |
| Update Status | Move a lead to a different pipeline status — stages are loaded dynamically from your account |
| Get Health Report | Fetch the most recent AI health report for a lead, including plan-gated metrics and PDF download URL |
| List Health Reports | Paginated list of all AI health reports for a lead |
| Delete | Permanently delete a lead |

> Dynamic fields: When you create or update a lead, the node automatically fetches your custom field definitions from Brixfit and shows them as individual inputs. Click Refresh to reload after adding new fields.
>
> Plan-gated metrics: Health metrics (BMI, BMR, TDEE, body fat %) in Create and health report responses are filtered to only include what your Brixfit plan allows.

Client

| Operation | Description |
|———–|————-|
| Get All | List clients with search and status filter. Enable Return All to auto-fetch every page. |
| Get | Fetch a single client by ID |
| Update | Update account status, goal, phone, end date or notes |
| Deactivate | Deactivate a client account |
| Get Check-ins | Fetch all check-ins for a specific client, with status and date filters |
| Get Health Report | Fetch the most recent AI health report for a client, including plan-gated metrics and PDF download URL |
| List Health Reports | Paginated list of all AI health reports for a client |

Check-in

| Operation | Description |
|———–|————-|
| Get All | List check-ins with filters (status, date range, client ID, pagination). Enable Return All to auto-fetch every page. |
| Get by Client | Fetch all check-ins for a specific client ID |

Webhook

| Operation | Description |
|———–|————-|
| Get All | List all registered webhooks |
| Create | Register a new webhook endpoint |
| Enable / Disable | Toggle a webhook’s is_active state without deleting it |
| Delete | Remove a webhook |

—

Trigger Events

The Brixfit Trigger node starts your workflow when any of these events fire:

| Event | When it fires |
|——-|————–|
| lead.created | A new lead is added |
| lead.updated | A lead’s details are changed |
| lead.status_changed | A lead moves to a new pipeline stage |
| lead.converted | A lead is converted to a client |
| lead.deleted | A lead is deleted |
| client.created | A new client is onboarded |
| client.updated | A client’s details are updated |
| client.deleted | A client account is deleted |
| checkin.submitted | A client submits a check-in |

All payloads are HMAC-SHA256 signed. The node verifies signatures using the original raw bytes and constant-time comparison — tampered or unsigned requests are rejected with HTTP 401. Replay protection rejects requests older than 5 minutes (configurable). The signing secret is stored internally after auto-registration; you never need to copy it manually.

Output format: payload fields are flattened to the top level so you can use $json.name, $json.email, $json.id directly in expressions. Meta fields are available as $json.event, $json.timestamp, $json.coachid.

—

Example Workflows

1. Capture leads from any form → Brixfit

Typeform / Tally / Facebook Lead Ads Trigger
  → Set (map name, email, phone, goal)
  → Brixfit: Create Lead

2. New lead → WhatsApp + Google Sheets

Brixfit Trigger (lead.created)
  → WhatsApp: Send welcome message to lead
  → Google Sheets: Append row

3. Client check-in submitted → Slack notification

Brixfit Trigger (checkin.submitted)
  → Slack: Send message to #coach-alerts
        "{{ $json.client_name }} just submitted their check-in"

4. Daily check-in report → Email

Schedule Trigger (every day at 9am)
  → Brixfit: Get All Check-ins (from_date: today, status: pending)
  → Gmail: Send summary to coach

5. Lead status changed → CRM sync

Brixfit Trigger (lead.status_changed)
  → IF (status == "converted")
      → HubSpot: Create Contact
      → Slack: Notify sales team

6. Auto-assign workout when client is created

Brixfit Trigger (client.created)
  → Brixfit: Get client details
  → HTTP Request: Trigger internal workflow

—

Data Handling

When creating or updating leads via this node, Brixfit automatically:

• Calculates body metrics (BMI, BMR, TDEE, body fat %) from height, weight, age, gender, and activity level fields — no manual calculation needed
• Normalizes phone numbers — strips trunk zeros, handles international formats (00XX → +XX)
• Validates and casts field types — numbers stay numbers, dates become ISO strings, booleans are properly coerced

—

Security

This node follows security best practices out of the box:

• HMAC-SHA256 webhook verification — uses raw request bytes and constant-time comparison
• SSRF protection — Base URL is validated; private/internal network addresses are rejected
• Path traversal prevention — all ID parameters are validated against an allowlist before use in URLs
• 30-second request timeout — prevents n8n executions from hanging on slow API responses
• Live credential testing — API key is verified immediately on Save

—

Resources

• Brixfit website
• API documentation
• Developer dashboard (login required — API keys & webhooks)
• npm package
• GitHub repository
• Changelog
• Report a bug
• Contact support

—

Changelog

See the CHANGELOG folder for full version history.

| Version | Date | Summary |
|———|——|———|
| v1.3.4 | 2026-06-01 | Fix package bloat: icon resized 1250px→60px (−99.5%), removed duplicate inclusion |
| v1.3.3 | 2026-05-31 | New icon (PNG), updated API docs URL, support email added |
| v1.3.1 | 2026-05-31 | Trigger: flat output, replay protection, events auto-sync, options panel, client.deleted event |
| v1.3.0 | 2026-05-31 | Auto-registration, health reports, plan-gated metrics, Return All, dynamic statuses, 16 bug fixes |
| v1.2.2 | 2026-03-26 | Webhook Enable/Disable operation — complete API coverage |
| v1.2.1 | 2026-03-22 | Complete reliability + UI fixes: error surfacing, filter preservation, JSON error handling |
| v1.2.0 | 2026-03-22 | Security hardening, reliability improvements, credential testing, UI fixes |
| v1.1.0 | 2026-03-21 | Dynamic lead fields, client update/deactivate, check-in by client |
| v1.0.0 | 2026-03-21 | Initial release |

—

Support

• Bugs / feature requests: GitHub Issues
• General support: support@brixfit.app
• API reference: brixfit.app/api-docs
• Developer dashboard: brixfit.app/coach/developer

—

Contributing

Pull requests are welcome. For major changes, please open an issue first.

—

License

MIT — © 2026 Jatin Beniwal / Brixfit