Overview
This guide explains how to integrate xMatters on the App Catalog page in Josys.
Integration Specifications
| Target Plans | Free, Starter, Base, Advanced |
|---|---|
| Integration Admin Type | Full Access User, Company Supervisor |
| Integration Method | API Key/Token |
| Integration Key | |
| Supported Features | Account Visualization |
| Account Visualization | Suspended Active Deleted |
| Statuses Excluded from Unmanaged ID Detection | Deleted |
| Provisioning Settings | |
| Deprovisioning Settings | |
| Contract Information | Please contact your representative for details. |
| Other Retrieved Items | • License Type • Site • Last Login • Created At • Updated At • Groups |
| Retrieved Fields |
・Last Active Date/Time ・License ・Role ・Status ・License ・Type ・Site ・Last Login ・Created At ・Updated At ・Groups |
| Retrieved Items for License Management | |
| Inactive User Definition | No activity for 30 days |
| Common Fields | Last Active License Role Status User |
| Retrieved Roles | Default Roles |
| Role Editing |
Generating an API Token
- Log in to xMatters with a
Full Access UserorCompany Supervisoraccount, and clickProfile > More Actions > Manage API Keys. - Click
Create API Key Credentialto generate and copy the API Key and Secret.
Integrating with Josys
- From the left sidebar of Josys, click Integrations > App Catalog.
- Search for and click xMatters.
- The integration settings page will appear on the right side.
- Enter the subdomain, API Key, and API Secret Key, then click Next to complete the integration.
The subdomain can be found in your login URL.
Example: If the URL is https://josys-dev.xmatters.com, enter "josys-dev".