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

# Amex GBT Neo

> Connect Amex GBT Neo to Serval to automate travel workflows using trip and itinerary data.

## About Amex GBT Neo

Amex GBT Neo is American Express Global Business Travel's corporate travel and
expense management platform. Connecting Amex GBT Neo to Serval lets your team
build workflows that read travelers' trips and itineraries through the Amex GBT
**Get Trips API**.

<Info>
  This integration uses the Amex GBT developer platform
  ([developer.amexgbt.com](https://developer.amexgbt.com), with a certification
  environment at [developer.cert.amexgbt.com](https://developer.cert.amexgbt.com)).
  Access requires an approved developer app with the Get Trips API enabled.
</Info>

## What the Amex GBT Neo integration enables

| Capability  | Description                                                                 |
| ----------- | --------------------------------------------------------------------------- |
| Trips       | List trips (travel itineraries) filtered by date range, traveler, or status |
| Trip detail | Retrieve a single trip and its segments (air, hotel, car, rail) by ID       |

Anything exposed by the Get Trips API for your approved app can be used from
Serval workflows.

***

## Amex GBT Neo configuration

### Prerequisites

Before connecting Amex GBT Neo, make sure you have:

* A registered account on the Amex GBT developer portal
* An **approved app** (e.g. `Blackstone-GetTripsApp`) with the Get Trips API enabled
* The app's **Client ID** and **Client Secret**
* Your Amex GBT API host (the certification host such as `api.cert.amexgbt.com`
  for testing, or the production host for live data)

<Info>
  Serval authenticates with Amex GBT using **OAuth 2.0 client credentials**. It
  exchanges your Client ID and Secret for a short-lived Bearer access token, then
  sends it as `Authorization: Bearer <token>` on each request. You do not need to
  configure a redirect URL.
</Info>

### Create an app in the Amex GBT developer portal

<Steps>
  <Step title="Register and sign in">
    Register at [developer.amexgbt.com](https://developer.amexgbt.com) (or the
    certification portal) and sign in.
  </Step>

  <Step title="Create or open your app">
    Under **My Apps**, create an app (or open your existing app, e.g.
    `Blackstone-GetTripsApp`) and request access to the **Get Trips API**.
  </Step>

  <Step title="Wait for approval">
    Amex GBT reviews and approves API access for the app. Confirm the Get Trips
    API shows as enabled before continuing.
  </Step>

  <Step title="Copy the credentials">
    Copy the app's **Client ID** and **Client Secret**. You will enter these in
    Serval.

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

***

## Serval configuration

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

2. Enter the following information:

   | Field         | Description                                                                                                         |
   | ------------- | ------------------------------------------------------------------------------------------------------------------- |
   | API Domain    | Your Amex GBT API host, such as `api.cert.amexgbt.com` (cert) or the production host. Omit `https://` and any path. |
   | Client ID     | The app's OAuth **Client ID**                                                                                       |
   | Client Secret | The app's OAuth **Client Secret**                                                                                   |

3. Click **Save**

<Check>
  After connecting, Serval can call the Amex GBT Get Trips API in workflows. You
  can confirm connectivity with the built-in healthchecks (test connection, list
  trips).
</Check>

***

## Additional resources

* [Amex GBT Developer Portal](https://developer.amexgbt.com)
* [Amex GBT Neo](https://www.amexglobalbusinesstravel.com/neo/)

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