Reference · built on requestConnectorField service & CMMS

Facilio

Work orders, service requests, assets, sites, inventory, and procurement from Facilio's Connected CMMS through REST API v5.

About

Facilio is a Connected CMMS for property portfolios. REST API v5 covers work orders and their tasks, service requests, assets, the site, building, floor, and space hierarchy, tenants, vendors, and clients, inventory item types, storerooms, and bins, and procurement from quotes and purchase requests to purchase orders, receivables, and invoices. Each module has a metadata endpoint that describes its fields, and GET /modules lists the modules your key can reach, including custom modules.

Through Fibric, an operator polls list endpoints with the changed parameter, reads a record's tasks and comments, and proposes a new work order, a task, a status change, or a purchase request. After your approval the write happens once, and the record shows the values before and after.

This is a reference listing. It documents what Fibric would read from Facilio and what it could propose, based on the vendor's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Work orders through GET /workorder with filters such as status, priority, site, and assignedTo, plus tasks and comments under /workorder/{id}
  • Records created or modified since a UTC timestamp, through the changed parameter on any list endpoint
  • Service requests through /servicerequest with attachments and comments, and picklists for moduleState and urgency
  • Assets through /asset, and the portfolio hierarchy through /site, /building, /floor, and /space
  • Storeroom balances and per-bin quantities through /item, /item/{id}/bin, /tool, and /storeroom
  • Quotes, purchase requests, purchase orders, receivables, and invoices through their module endpoints and moduleState picklists
  • Field schemas through GET /{moduleName}/metadata, including type, required, readOnly, and lookup target

Proposed actions

  • Target capability: propose a work order through POST /workorder, which needs at least subject and site
  • Target capability: propose a PATCH to a work order or service request; omitted fields stay unchanged
  • Target capability: propose tasks and task photos on a work order through /workorder/{id}/tasks
  • Target capability: propose a purchase request or an inventory request through POST /purchaserequest and POST /inventoryrequest
  • Target capability: propose a stock adjustment through POST /item/adjustment, or a receipt against a PO through /receivable/{id}/addreceipt

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Surface work orders stalled past due

    GET /workorder filtered by status and dueDate(before) finds orders past their date. The operator proposes a reassignment or a priority change and records the reason.

    With Work Order Aging

  • Turn a service request into the right work order

    New service requests carry urgency and site. The operator proposes the work order to create from each, with category and assignee, and waits for your approval.

    With Request Routing

  • Keep storerooms stocked for planned work

    Item balances per storeroom and bin show what will run short against open work orders. The operator drafts a purchase request for your approval.

    With Spares Reorder

  • Reconcile receipts, purchase orders, and invoices

    Receivables show what arrived against each purchase order and invoices carry their own status. The operator flags mismatches and proposes the invoice status change.

    With Three-Way Match

Requirements

  • A Facilio organization in one of the regions us, au, ae, uk, us-azure, or sa, addressed as https://{region}.facilioapis.com/{app_name}/api/v5
  • An API key generated from your Facilio account settings; it inherits the permissions of the user who created it
  • For OAuth2, a developer app registered with Facilio, using /identity/oauth2/authorize and /identity/oauth2/token
  • Each module enabled for your organization; a disabled module answers MODULE_NOT_ENABLED
Authentication
An API key (personal access token) in the x-api-key header against the maintenance app, or OAuth2 authorization_code or password grants against the developer app with Authorization: Bearer oauth2 <access_token>.

Limits

  • 100 requests per minute per API key or OAuth2 token; HTTP 429 with code RATE_LIMITED when exceeded
  • pageSize is capped at 200 records, expand accepts at most 5 lookup fields, and Big String fields are excluded from list responses
  • The v5 specification defines no outbound webhook; change detection uses the changed parameter on list endpoints
  • Creating or updating a record runs workflow rules unless the request sets X-Execute-Workflows: false

Access and pricing

Reference listing. Fibric builds the connector under a managed deployment when you request it. Your quote covers the build, capabilities, usage, and support.

Request Facilio ↗

Questions and answers

How does Facilio's API paginate and filter?
List endpoints take page (1-based) and pageSize up to 200, plus select, expand for up to 5 lookups, search, sortBy, sortOrder, view, and count. Filters are query parameters: exact match like status=Submitted, or operator form like createdTime(after)=2026-01-01T00:00:00Z. Comma-separated values OR within one field; separate fields AND.
Is there a way to sync only what changed?
Yes. Pass changed with a UTC timestamp in yyyy-MM-dd'T'HH:mm:ss'Z' format to any list endpoint. It returns records whose created or modified time is after that point, and it combines with other filters.
What are the rate and size limits?
100 requests per minute per API key or OAuth2 token, answered with HTTP 429 and the code RATE_LIMITED. String fields hold 255 characters, Large Text 2,000, and Big String 32,000. Values over the limit fail with VALIDATION_ERROR.
Ask about Facilio

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.