> ## 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.

# Egencia by Amex GBT

> Connect Egencia (by Amex GBT) to Serval to automate corporate travel and expense workflows.

## About Egencia

Egencia (an American Express Global Business Travel brand) is a corporate travel
management platform. Connecting Egencia to Serval lets your team build workflows
that read trips, bookings, traveler profiles, expenses, reporting, and
duty-of-care data through the **Egencia OpenConnect APIs**.

<Info>
  This integration is currently in **beta**. The available endpoint surface is
  modeled from Egencia's public developer documentation and is reconciled with the
  official Egencia API specification supplied during developer on-boarding.
</Info>

## What the Egencia integration enables

| Capability       | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| Bookings & trips | Retrieve trip and booking details, segments, and itineraries |
| User sync        | Read, create, update, and deactivate traveler user profiles  |
| Expense          | Read travel expenses, invoices, and receipt artifacts        |
| Reporting        | Request and retrieve reporting data and dashboards           |
| Duty of care     | Locate travelers on the road for safety and compliance       |

Anything available through your Egencia API client can be used from Serval
workflows.

***

## Egencia configuration

### Prerequisites

Before connecting Egencia, make sure you have:

* An Egencia account with the **OpenConnect APIs** provisioned
* API **Client credentials** (a Client ID and Client Secret) issued by Egencia
  during API on-boarding

<Info>
  Serval authenticates with Egencia using standard OAuth 2.0 **client
  credentials** (server-to-server). It exchanges your Client ID and Secret for a
  short-lived bearer token at `https://apis.egencia.com/auth/v1/token`, then sends
  that token in the `Authorization: Bearer` header on each request. You do not
  need to configure a redirect URL.
</Info>

### Obtain API credentials from Egencia

<Steps>
  <Step title="Request API access">
    Work with your Egencia account team to enable the OpenConnect APIs and begin
    API on-boarding for your account.
  </Step>

  <Step title="Receive your client credentials">
    During on-boarding, Egencia issues a **Client ID** and **Client Secret**.
    These authenticate Serval to the Egencia APIs.

    <Warning>
      Store the Client Secret securely. Egencia may not show it again after
      on-boarding.
    </Warning>
  </Step>
</Steps>

***

## Serval configuration

1. In Serval, go to **Apps > Available > Egencia by Amex GBT > Connect**

2. Enter the following information:

   | Field         | Description                                                                  |
   | ------------- | ---------------------------------------------------------------------------- |
   | Account Name  | A label for this Egencia account (used to identify the connection in Serval) |
   | Client ID     | The Egencia API **Client ID**                                                |
   | Client Secret | The Egencia API **Client Secret**                                            |

3. Click **Save**

<Check>
  After the connection is saved, Serval can call the Egencia OpenConnect APIs in
  workflows. You can confirm connectivity with the built-in healthchecks (test
  connection, list bookings, list reports).
</Check>

***

## Additional resources

* [Egencia Developer Center](https://www.amexglobalbusinesstravel.com/egencia-developer-center/api-overview)

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