MAFM REST API

Build powerful integrations with MAFM's facilities management platform

← Back to MAFM

Welcome to the MAFM API

The MAFM REST API provides a standard HTTP interface to integrate your systems with our facilities management platform. Create, retrieve, update, and delete service requests, move requests, and more through simple RESTful endpoints.

This API uses standard HTTP methods (GET, POST, PUT, DELETE), returns JSON responses, and requires Bearer token authentication for all requests.

Quick Start

  1. Go to MAFM Settings → API Tokens
  2. Click "Create API Token" and give it a name
  3. Copy your token (starts with mafm_live_)
  4. Use it in the Authorization: Bearer YOUR_TOKEN header

API Base URL

https://api.mafm.app/v1

Key Features

Available Endpoints

Service Requests

Create, retrieve, update, and manage service requests for building maintenance and repairs.

GET/POST/PUT/DELETE /v1/service-requests
View Documentation →

Move Requests

Handle furniture and equipment move requests across building locations.

GET/POST/PUT/DELETE /v1/move-requests
View Documentation →

Buildings

Retrieve building and floor information for your company facilities.

GET /v1/buildings
View Documentation →

Authentication

All API endpoints require Bearer token authentication. You can create an API token in your MAFM account settings under the "API Tokens" section.

Creating an API Token

  1. Log in to MAFM and navigate to Settings → API Tokens
  2. Click "Create API Token"
  3. Enter a name for your token (e.g., "Integration Server", "N8N Workflow")
  4. Select the scopes/permissions needed (or use * for full access)
  5. Click "Create" and copy your token immediately (it won't be shown again)

Using Your Token

Include your API token in the Authorization header using the Bearer scheme:

# Using cURL
curl -X GET https://api.mafm.app/v1/service-requests \
  -H "Authorization: Bearer mafm_live_YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json"

# Create a service request
curl -X POST https://api.mafm.app/v1/service-requests \
  -H "Authorization: Bearer mafm_live_YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Replace ceiling light in Room 205",
    "title": "Light Replacement - Room 205",
    "priority": "Medium",
    "location": {
      "building": "A",
      "floor": "2",
      "area": "Room 205"
    }
  }'
⚠️ Important: Store your API tokens securely. Never expose them in client-side code, public repositories, or commit them to version control. Each token is tied to your company and user account. If a token is compromised, revoke it immediately in the API Tokens settings.