/* BEGIN BLOG-CLOSE-CHAT */ /* END BLOG-CLOSE-CHAT */
View Categories

7 — Reference

3 min read

7 — Reference #

Permission Reference #

The table below lists every permission key, the menu/feature it unlocks, and which edition supports it.

Fax Permissions #

Permission Key Display Name Menu / Feature EE CE
send_fax Send Fax Fax → Send Fax
receive_fax Receive Fax Fax → Inbox
faxtoemail Fax to Email Automatic email on receive
emailtofax Email to Fax Inbound email → fax pipeline
personalize_fax Personalize Fax Custom sender ID
campaigns Bulk Fax Fax → Campaigns
cover_page Cover Page Fax → Cover Page
resources.fax_documents Fax Documents Fax → Fax Documents
fax_accounts Fax Accounts Fax → Fax Accounts
fax_setting Fax Settings Fax → Fax Settings

Contacts Permissions #

Permission Key Display Name Menu / Feature EE CE
contacts Contacts Contacts → Contacts
groups Contact Groups Contacts → Groups
contact_dnc Contact DNC Contacts → Do Not Call

PBX Permissions #

Permission Key Display Name Menu / Feature EE CE
fpbx_extension Extensions PBX → Extensions
devices Devices PBX → Devices
ring_groups Ring Groups PBX → Ring Groups
call_queues Call Queues PBX → Call Queues
ivr_menus IVR Menus PBX → IVR Menus
voicemails Voicemail PBX → Voicemail
conferences Conferences PBX → Conferences
time_conditions Time Conditions PBX → Time Conditions
call_flows Call Flows PBX → Call Flows
call_block Call Block PBX → Call Block
follow_me Follow Me PBX → Follow Me
musiconhold Music on Hold PBX → Music on Hold
inbound_routes Inbound Routes PBX → Inbound Routes
realtime Realtime PBX → Realtime

Administration Permissions (system-level, admin only) #

Permission Key Feature
user_admin Manage users (Administration → Users)
gateways Manage SIP gateways/trunks
super_admin Full system administration

PBX Resource Types #

Resource ID Resource Permission Key User form field
15 Extensions fpbx_extension quota_extensions
16 Devices devices quota_devices
7 Ring Groups ring_groups quotaringgroups
8 Call Queues call_queues quotacallqueues
17 IVR Menus ivr_menus quotaivrmenus
9 Voicemail Boxes voicemails quota_voicemail
10 Conferences conferences quota_conference
11 Music on Hold musiconhold quotamusicon_hold

User Roles #

Role Name Role ID (EE prod) Capabilities
User 1 End-user; access only to explicitly granted features
Admin 2 Full system access; no permission filtering
Tenant 3 Manages users within their tenant; permission-filtered

Note: Role IDs differ per installation. Never hardcode them — ICTPBX always maps by name internally.


API Overview #

All ICTPBX functionality is exposed via a JSON REST API at /api.

Authentication: Authorization: Bearer <JWT> (RS256, 1-year expiry)

Base URL: https://<your-server>/api

Key Endpoints #

Method Path Description
POST /auth Login — returns JWT
GET /users List users
POST /users Create user
GET /users/{id} Get user
PUT /users/{id} Update user
DELETE /users/{id} Delete user
GET /tenants List tenants (admin only)
POST /tenants Create tenant (admin only)
GET /billing/quota PBX resource quota summary
GET /fpbx_extension/extensions List extensions
POST /fpbx_extension/extensions Create extension
GET /devices/devices List devices
GET /ringgroups/ringgroups List ring groups
GET /callqueues/callqueues List call queues
GET /ivrmenus/ivrmenus List IVR menus
GET /voicemails/voicemails List voicemail boxes
GET /transmission List fax transmissions
POST /transmission Send a fax
GET /accounts List fax accounts
GET /cdr Call detail records

All list endpoints support ?page=N&per_page=N&search=<term> for pagination and filtering.


localStorage Keys (Frontend) #

These keys are written at login and read throughout the UI:

Key Value Used for
aid User ID API calls
tid Tenant ID Scoping requests
is_admin 1 or 0 Admin vs non-admin UI branching
is_tenant 1 or 0 Tenant admin detection
permission Comma-delimited string User’s own permissions
tenant_permissions Comma-delimited string Tenant’s permissions (used for what can be granted to sub-users)
tenantdailylimit Number Tenant fax daily cap
tenantmonthlylimit Number Tenant fax monthly cap
tenantassigneddaily Number Already-assigned daily quota
tenantassignedmonthly Number Already-assigned monthly quota
theme_pref Theme name UI theme preference

Supported SIP Codecs #

Codec Voice Fax
G.722 ✅ HD
G.711 PCMU ✅ (pass-through)
G.711 PCMA ✅ (pass-through)
T.38 ✅ (preferred, requires re-INVITE)

Fax calls negotiate T.38 first; fall back to G.711 PCMA pass-through if the far end rejects T.38.