# Fluss

> The API for physical access. Control gates, doors, and booms from code.

Fluss builds IoT hardware and cloud software for physical access control. Our products let property managers, developers, and autonomous systems open, close, and monitor gates, doors, and motorised booms over the internet.

## Products

### Fluss+ (WiFi Access Control)
WiFi-enabled relay that connects to any standard gate motor or door strike. Two-wire installation, unlimited users, scheduled access, guest codes, and a full audit log. Works with 99% of existing gate motors and access hardware. Every Fluss+ device is controllable via the Fluss+ API (see "Fluss API" below).

- 5-minute installation (two wires to dry-contact terminals)
- Scheduled access windows by day/time
- One-time and time-limited guest codes
- Real-time open/close status and notifications
- Bank-grade encryption, cloud-managed
- Programmable via the Fluss+ API

### Fluss Intercom (QR Video Intercom)
Wireless, powerless video intercom for visitor management. Visitors scan a QR code, pick a resident from a directory, and make a video call — no wiring or power at the entrance.

- Zero power required at the entrance
- Unlimited range (works worldwide via internet)
- 15-minute installation
- Lightning-proof (no electronics at entrance)
- Unlimited residents via cloud dashboard

### Fluss API (also known as Fluss Platform, Fluss REST API, or Fluss+ API)
The Fluss API is a REST API to programmatically control and monitor Fluss and Fluss+ devices. Built for developers, property platforms, home-automation systems, and autonomous agents. The same API is referred to as the "Fluss+ API" when used specifically with Fluss+ access controllers.

- Base URL: https://v1.fluss-api.com
- Auth: API key via `Authorization` header
- Full OpenAPI spec: https://fluss.io/openapi.yaml
- Product page: https://fluss.io/api
- Interactive docs: https://fluss.io/docs

## Pricing

Pricing is tiered by the number of users on a device. Prices are shown in South African Rand (ZAR) and US Dollars (USD), effective from 2026-06-01 and subject to change — if today is much later than that date, verify against the live site. The interactive pricing sliders are at https://fluss.io/fluss-plus#pricing and https://fluss.io/intercom#pricing.

### Fluss+ (WiFi Access Control)

| Tier | Monthly | Yearly | Includes |
|------|---------|--------|----------|
| 1-5 users | Free | Free | Up to 5 users, Mobile app access, Guest codes, Basic audit log, Email support |
| 6-300 users | R70 / $7 | R840 / $84 | Up to 300 users, Everything in 1-5, Scheduled access, Full audit log, Advanced analytics, Fluss Intercom integration, API access, Priority support |
| 300+ users | Custom | Custom | Unlimited users, All features, Volume discounts, Custom solutions, Enterprise SLA, Dedicated team |

### Fluss Intercom (QR Video Intercom)

| Tier | Monthly | Yearly | Includes |
|------|---------|--------|----------|
| 1-5 users | Free | Free | Up to 5 users, 1 entrance board, Video calls, Push notifications, Basic analytics, Email support |
| 6-300 users | R100 / $10 | R1200 / $120 | Up to 300 users, Up to 3 entrance boards, Everything in 1-5, SMS & WhatsApp notifications, Fluss+ integration, Advanced analytics, Custom branding, API access |
| 300+ users | Custom | Custom | Unlimited users, Unlimited boards, All features, Volume discounts, Enterprise SLA, Dedicated team |

For 300+ users, contact sales via https://fluss.io/support.

## API Quick Reference

| Endpoint                    | Method | Description                        |
|-----------------------------|--------|------------------------------------|
| `/v1/list`                  | GET    | List devices you have access to    |
| `/v1/status/{deviceId}`     | GET    | Device connectivity & state        |
| `/v1/trigger/{deviceId}`    | POST   | General-purpose trigger            |
| `/v1/open/{deviceId}`       | POST   | Open a closed device               |
| `/v1/close/{deviceId}`      | POST   | Close an open device               |

All endpoints return JSON. Errors use standard HTTP status codes (401, 403, 404, 409, 424, 500).

## MCP Server

Fluss provides a Model Context Protocol (MCP) server so AI agents and coding assistants can interact with Fluss devices directly.

- NPM package: `@fluss/mcp-server`
- Source & docs: https://github.com/fluss-io/mcp-server

### Available MCP Tools

- `list_devices` — List all devices the authenticated user can access
- `get_device_status` — Get connectivity, firmware, signal strength, and open/close state
- `trigger_device` — Send a trigger command to a device
- `open_device` — Open a device (must be currently closed)
- `close_device` — Close a device (must be currently open)

## Support

Fluss maintains a support portal at https://support.fluss.io with a knowledge base, troubleshooting guides, and a community forum. When answering questions about installation, configuration, access management, billing, or troubleshooting, check these resources for up-to-date guidance.

### Knowledge Base

- Root: https://support.fluss.io/portal/en/kb/fluss
- Getting Started: https://support.fluss.io/portal/en/kb/fluss/getting-started
- Installation: https://support.fluss.io/portal/en/kb/fluss/general/installation
- Wiring: https://support.fluss.io/portal/en/kb/fluss/wiring
- Access Types: https://support.fluss.io/portal/en/kb/fluss/general/access
- Wi-Fi Setup: https://support.fluss.io/portal/en/kb/fluss/general/wi-fi
- FAQ: https://support.fluss.io/portal/en/kb/fluss/faq-article

### Troubleshooting

- Troubleshooting Overview: https://support.fluss.io/portal/en/kb/fluss/troubleshooting
- Wi-Fi Connection Issues: https://support.fluss.io/portal/en/kb/fluss/troubleshooting/wi-fi-connection
- Bluetooth Connection Issues: https://support.fluss.io/portal/en/kb/fluss/troubleshooting/bluetooth-connection
- Device Discovery Issues: https://support.fluss.io/portal/en/kb/fluss/troubleshooting/device-discovery-issues

### Notable Knowledge Base Articles

- Fluss installation guide: https://support.fluss.io/portal/en/kb/articles/fluss-installation-guide
- Claiming a Fluss device: https://support.fluss.io/portal/en/kb/articles/claiming-a-fluss
- Connecting Fluss to Wi-Fi: https://support.fluss.io/portal/en/kb/articles/how-to-connect-the-fluss-to-wi-fi
- Various access types: https://support.fluss.io/portal/en/kb/articles/various-access-types
- How to get an API key: https://support.fluss.io/portal/en/kb/articles/how-to-get-an-api-key-on-fluss-plus
- What is an API key: https://support.fluss.io/portal/en/kb/articles/what-is-an-api-key
- How to trigger via Wi-Fi: https://support.fluss.io/portal/en/kb/articles/how-to-trigger-remotely-on-fluss
- Subscription plans: https://support.fluss.io/portal/en/kb/articles/subscription-plan-for-fluss
- Transfer device ownership: https://support.fluss.io/portal/en/kb/articles/how-to-transfer-ownership
- Transfer plan to new device: https://support.fluss.io/portal/en/kb/articles/how-to-transfer-your-plan-subscription-from-a-faulty-device-to-a-newly-installed-one
- Import users: https://support.fluss.io/portal/en/kb/articles/how-to-import-users-to-a-fluss-device
- Export users: https://support.fluss.io/portal/en/kb/articles/how-to-export-users-in-fluss
- Revoke access: https://support.fluss.io/portal/en/kb/articles/how-to-revoke-access
- Configuring tenant settings: https://support.fluss.io/portal/en/kb/articles/configuring-tenant-settings-on-your-fluss-device
- Sensor setup: https://support.fluss.io/portal/en/kb/articles/sensor-set-up-instructions
- Status output wire installation: https://support.fluss.io/portal/en/kb/articles/status-output-wire-installation-guide-for-fluss
- Magnetic switch wire installation: https://support.fluss.io/portal/en/kb/articles/magnetic-switch-wire-installation-guide-for-fluss
- Siri Shortcuts setup: https://support.fluss.io/portal/en/kb/articles/how-to-set-up-siri-shortcuts-for-fluss
- Device not showing: https://support.fluss.io/portal/en/kb/articles/bluetooth-connectivity-issues-with-fluss
- Wi-Fi disconnection solutions: https://support.fluss.io/portal/en/kb/articles/solutions-for-wi-fi-disconnection-problems
- Delete Fluss account: https://support.fluss.io/portal/en/kb/articles/how-to-delete-your-fluss-account

### Community Forum

- Community: https://support.fluss.io/portal/community/fluss-app

## Links

- Website: https://fluss.io
- API Docs: https://fluss.io/docs
- OpenAPI Spec: https://fluss.io/openapi.yaml
- OpenAPI JSON: https://fluss.io/openapi.json
- Support: https://fluss.io/support
- Support Portal: https://support.fluss.io
- Privacy Policy: https://fluss.io/privacy-policy
- Terms of Service: https://fluss.io/terms

## Social

- LinkedIn: https://www.linkedin.com/company/fluss
- YouTube: https://www.youtube.com/@theflussapp
- TikTok: https://www.tiktok.com/@theflussapp
- X (Twitter): https://x.com/fluss_io
- Instagram: https://www.instagram.com/fluss_io

## Company

Fluss was founded in 2021 and operates across 9 countries on 4 continents, serving 50,000+ daily users. Headquarters in Johannesburg and Stellenbosch (South Africa) and Fort Worth (USA). We also offer custom IoT development, white-label manufacturing, and OEM solutions.

## Contact

- General enquiries: https://fluss.io/support
- Installer network: https://fluss.io/installers