> ## Documentation Index
> Fetch the complete documentation index at: https://docs.serval.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Accruent EMS

> Connect Accruent EMS to Serval to automate room, desk, and event scheduling workflows.

## About Accruent EMS

Accruent EMS (formerly EMS Software) is a workplace, room, desk, and event
scheduling platform used across higher education and corporate offices.
Connecting EMS to Serval lets your team build workflows that read from and write
to EMS through the **EMS Platform Services API**.

<Info>
  This integration targets the EMS **Platform Services API** specifically. It is
  scoped to EMS and does not cover other Accruent products (Maintenance
  Connection, Lucernex, Meridian, etc.), which expose their own separate APIs.
</Info>

## What the Accruent EMS integration enables

| Capability              | Description                                                          |
| ----------------------- | -------------------------------------------------------------------- |
| Space data              | Look up buildings, rooms, room types, areas, floors, and setup types |
| Bookings & reservations | Read and manage bookings, reservations, and statuses                 |
| Groups & users          | Look up groups, group types, web users, and related directory data   |
| Service orders          | Read and manage service orders and related resources                 |

Anything available through your EMS Platform Services integration client can be
used from Serval workflows.

***

## Accruent EMS configuration

### Prerequisites

Before connecting EMS, make sure you have:

* Administrator access to the EMS Platform Services Admin (Configuration) portal
* EMS Platform Services enabled for your environment
* Your EMS API domain, such as `ems05.emscloudservice.com` (for EMS Cloud)
* Permission to create an integration client (which provides a Client ID and
  Secret)

<Info>
  Serval authenticates with EMS using a client (server-to-server) integration. It
  exchanges your Client ID and Secret for a short-lived token via
  `POST /platform/api/v1/clientauthentication`, then sends that token in the
  `x-ems-api-token` header on each request. You do not need to configure a
  redirect URL.
</Info>

### Create an integration client in EMS

<Steps>
  <Step title="Open the Platform Services integrations settings">
    In the EMS Admin (Platform Services Configuration) portal, go to the
    **Integrations** configuration area.
  </Step>

  <Step title="Create an integration client">
    Create a new integration client (sometimes called an "API client" or
    "Integration"). Use a recognizable name such as `Serval Integration`.
  </Step>

  <Step title="Grant the client access">
    Ensure the client has access to the EMS data your workflows need (for example,
    the buildings, rooms, bookings, and groups your automations will read or
    write).
  </Step>

  <Step title="Copy the client credentials">
    Save the client, then copy the generated **Client ID** and **Secret**. You
    will enter these in Serval.

    <Warning>
      Store the secret securely. EMS may not show it again after you leave the
      client details page.
    </Warning>
  </Step>
</Steps>

***

## Serval configuration

1. In Serval, go to **Apps > Available > Accruent EMS > Connect**

2. Enter the following information:

   | Field         | Description                                                                                  |
   | ------------- | -------------------------------------------------------------------------------------------- |
   | API Domain    | Your EMS instance domain, such as `ems05.emscloudservice.com`. Omit `https://` and any path. |
   | Client ID     | The EMS integration client **Client ID**                                                     |
   | Client Secret | The EMS integration client **Secret**                                                        |

3. Click **Save**

<Check>
  On save, Serval validates the credentials by minting an EMS client token. After
  the connection succeeds, Serval can call the EMS Platform Services API in
  workflows. You can confirm connectivity with the built-in healthchecks
  (test connection, list buildings, list rooms, list groups).
</Check>

***

## Additional resources

* [EMS Platform Services — Introduction](https://help.accruent.com/ems/Content/EMSPlatformServices/InstallationGuide/Introduction.html)
* [EMS API home](https://help.accruent.com/ems/Content/OptionalFeatures/2_EMS_API_Home.htm)

Need help? Contact **[support@serval.com](mailto:support@serval.com)** for assistance with your Accruent EMS
integration.