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

# Tipalti

## What's Supported

### Supported Actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://api-p.tipalti.com`.

### Example integration

To define an integration for Tipalti, create a manifest file that looks like this:

```YAML theme={null}
# amp.yaml
specVersion: 1.0.0
integrations:
  - name: tipalti-integration
    displayName: My Tipalti Integration
    provider: tipalti
    proxy:
      enabled: true
```

## Before You Get Started

To connect Tipalti with Ampersand, you will need a [Tipalti Account](https://tipalti.com/).

Once your account is created, you'll need to configure an app in Tipalti and obtain the following credentials from your app:

* Client ID
* Client Secret

You will use these credentials to connect your application to Ampersand.

### Creating a Tipalti App

Follow the steps below to create a Tipalti app and add the Ampersand redirect URL:

1. Log in to your [Tipalti SSO Portal](https://login.tipalti.com/login/hub).

2. Navigate to **Administration** in the left sidebar.

3. Click on **API Management** or **Developer Settings**.

4. Click the **Register New Application** button.

5. In the application registration form, enter the following details:
   * **Application Name**: Enter a descriptive name for your application
   * **Application Description**: Provide a brief description of your integration
   * **Redirect URI**: Enter the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`
   * **Scopes**: Select the required permissions for your integration

6. Click **Register Application**.

7. Once your app is registered, you'll be redirected to the application details page where you can find your **Client ID** and **Client Secret**.

**Note**: Make sure to securely store the **Client ID** and **Client Secret** as you will need these credentials to connect your app to Ampersand.

### Add Your Tipalti App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Tipalti integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=CkzFg-K1u4gYx3ZD&q=85&s=d580aa00cc421fe14cfbab79c2e0812f" alt="Ampersand Project" width="2244" height="442" data-path="images/provider-guides/dd47b7a-Ampersand.png" />

3. Select **Provider apps**.

4. Select *Tipalti* from the **Provider** list.

5. Enter the previously obtained *Client ID* in the **Client ID** field and the *Client Secret* in the **Client Secret** field.

6. Click **Save changes**.

## Using the connector

To start integrating with Tipalti:

* Create a manifest file like the [example above](#example-integration).
* Deploy it using the [amp CLI](/cli/overview).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for OAuth authorization.
* Start using the connector!
  * If your integration has [Proxy Actions](/proxy-actions), you can start making Proxy API calls.

## API documentation

For more information on the Tipalti API, visit the [Tipalti API documentation](https://documentation.tipalti.com/docs/getting-started).