Titan Cloud Edge <> Titan Maintenance Integration
Step-by-step instructions for configuring the Titan Cloud Edge and Titan Maintenance integration.
Written by Jess Hamilton
Updated at April 22nd, 2026
Table of Contents
Note: The Titan Cloud Edge <> Titan Maintenance Integration is currently one-way only. Future updates will expand functionality.
Step 1: Generate API Credentials in Titan Maintenance
Rest API User Setup and Credential Generation
Overview
Rest API users are Manager or Contractor/Supplier users that have been granted the appropriate permissions to access and use the Rest API functionality within the platform.
These users allow external systems to securely communicate with the platform through API calls, and are usually created to implement a specific integration.
To function correctly, a Rest API user must:
- Be configured as the correct type of user for the specific integration
- Be assigned Rest API access permissions
- Log in to the Titan Maintenance platform
- Generate an API Token and API Secret Key
These credentials are then used when configuring integrations between systems.
Best practice is to create a dedicated API user account rather than using a normal operational user account.
Create a Rest API User
Create the Management or Contractor user for the scenario.
- For a Titan Cloud Edge integration, create a Management user.
- Navigate to System > Users
- Click Operations and select Create
- For all other API access scenarios, create a Contractor user.
- Navigate to Manage > Contractors
- Locate and select the Contractor in list
- Click the Users tab
- Click Operations and select Create
Tip: For additional information on the user types, please see the User Management in Titan Maintenance article.
In the Create User window, click the Security tab.
Under Role Packages, use the arrows to move REST API and any other permissions required for the integration from the Available column to the Selected Column.
Tip: Titan Maintenance integrations require REST API and Management User permissions.
Click Save to create the user.
Recommended Best Practices
- Use a dedicated email address for the API account. For example:
api.integration@company.com system.api@clientdomain.com urgent.api@clientdomain.com
- Avoid using personal user accounts for integrations.
- Assign only the minimum permissions required.
Generate Credentials
Log in to the platform using the Rest API user account.
Click the person icon in the top-right corner of the screen to open the Account Settings menu.
Credential |
Description |
|---|---|
API Token |
Identifies the API user |
API Secret Key |
Used for secure authentication |
Security Best Practices
- Store these credentials securely.
- Do not expose them publicly or share them via unsecured channels.
- Only provide them to authorized integration systems.
- Regenerate credentials if security has been compromised.
Step 2: Connect Maintenance Tenant to Edge Client
Log in to Titan Cloud Edge as an Admin user and navigate to Administrative Console > Account Settings.
Locate the MaintenanceIntegration section.
- Select Titan Maintenance in the dropdown menu
- Toggle “Enable Maintenance Integration toggle” into the ON position
- Toggle “Allow Maintenance to Update Associated Activities toggle” into the ON position
- Map the following fields:
| Field in Account Settings | Data from Titan Maintenance |
|---|---|
| Maintenance ID | The Tenant name in Titan Maintenance |
| Maintenance User | This field can remain blank or input “Unspecified” |
| Client Secret | API Secret |
| Maintenance Password | API Token |
Step 3: Connect Maintenance Site to Edge Facility
In Titan Maintenance, navigate to Manage > Sites.
Locate the desired Site and copy the Site Identifier value.
Tip: The Site Identifier is used to map the site and facility. When a user creates a Work Order in Edge, they will see the Site Name in the dropdown menu.
In Titan Cloud Edge, navigate to the corresponding Facility Profile and select the Misc Information tab.
Scroll to the Data Vendor Mapping section and click the pencil edit icon.
Input the Site Identifier in the Titan Maintenance Facility field and click Update to save.
