Authentication

API keys, scopes, and which routes you can use with a key and which are dashboard-only.

Updated:

API keys

Keys are created by the Owner in Settings → Developers. They are shown once. Send your key as a bearer token:

GET /v1/me HTTP/1.1
Host: api.fiuit.com
Authorization: Bearer wg_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxx
PrefixMode
wg_live_Production data and real messages
wg_test_Read-only: it can list and read, not create or change anything. A sandbox for writes is Coming soon

Keys belong to one project (workspace). The project always comes from the key: there is no workspace id in paths or bodies. Keys are stored hashed.

Scopes

ScopeAllows
slots:readGET /slots
bookings:readRead bookings and tasks (/bookings, /work-items), stage history, attachments, team statistics
bookings:writeHolds, confirm, cancel, reschedule, check-in, no-show, complete, run actions and edit a task's priority, tags and due date
customers:readRead and search customers, their history, summary and comments
customers:writeCreate and edit customers
messages:readRead conversations and messages
messages:writeSend messages, switch the mode (bot or person), resolve, mark as read
config:read / config:writeServices, resources, teams, schedules, rule-based automations, knowledge and bot
settings:writeReplace and revert stages, actions and forms (/services/{id}/stages)
webhooks:manageOutgoing webhook endpoints
products:read / products:writeRead and manage the product catalog
payments:read, payments:read_balanceRead payments and task balances
payments:record, payments:link, payments:void, payments:adjust, payments:refund, payments:fiscalRecord payments, generate links, void, adjust, refund and mark fiscal details
expenses:read, expenses:record, expenses:void, expenses:approveRead, record, void and approve expenses
commissions:read, commissions:configure, commissions:adjust, commissions:settle, commissions:exportRead, configure, adjust, settle and export commissions
cash:read, cash:remit, cash:close, cash:configureRead cash, remit, close and configure
finance:analyze, finance:exportView and export Money reports
customer_balance:read, customer_account:readRead the customer balance and account statement
prepaid:read, prepaid:manage, prepaid:sell, prepaid:benefitsRead, manage and sell packages and clubs, and manage benefits
partner:readRead the dashboard of the partner who issued the key

A request without the needed scope returns 403 with code: "insufficient_scope".

Knowledge sources (/knowledge/sources) and the per-channel bot policy accept config:read / config:write. GET /connection/projects lists the credential’s projects; managing them remains dashboard-only.

What is dashboard-only

These areas do not accept API keys: they use the session of a team member (with their role) and are protected with CSRF. If you call them with a key, the API answers that they are not available for that type of credential.

  • Channels, channel and AI pauses, service status.
  • Automation rules (/automation-flows), the Wagy assistant and its plan.
  • Team, invitations, API keys, projects and platform support.
  • Team Telegram and alert preferences.

The endpoint list marks which is which.

Rotation

Create a new key, deploy it, then revoke the old one in Settings → Developers. Revoked keys return 401 immediately.