Import or synchronize data

xMatters provides several tools that allow you to quickly import data from external sources, or to synchronize user and group records between xMatters and another system, such an HR tool or identify provider application. The following tools may be available to you depending on your licensing model and permissions:

  • User upload: The user upload tool allows you to import user data from a spreadsheet. Using the User Upload template v1.5, you can quickly create a set of users in xMatters using a common tool. For more information about using the user upload feature, see Upload users.
  • EPIC: The EPIC (Export Plus Import Controller) utility allows you to synchronize user, group, and site data with an external system. ZipSync files created with EPIC can be sent to xMatters either using the xMatters REST API, or through the EPIC client. The EPIC client is typically used in conjunction with ETL tools to extract data from an external system and import it into xMatters, allowing you to maintain this information in an external system and update xMatters on a regular interval. For more information about working with EPIC, see Synchronize user data with EPIC.
  • SCIM: The System for Cross-Domain Identify Management (SCIM) is a specification designed to automate the management of user identities across cloud-based applications and services. For more information about the required configuration, best practices, and how to use SCIM, see Automated provisioning with SCIM.
    While SCIM can be used with any system that supports the spec, we have instructions for the following popular identity management applications:
    • Microsoft Entra ID (formerly known as Azure Active Directory)
    • Okta
  • xMatters REST API: The xMatters REST API allows you to programmatically create users from within any application that can make requests over HTTP. You can also upload xMatters User Upload template v1.5 files or EPIC ZipSync v1.3 files for processing. For more information about using the xMatters REST API, see Introduction to REST APIs.