# Showpad

> Source: https://truto.one/docs/integration-guides/showpad/

Showpad connects with OAuth 2.0 through an OAuth client you register in Showpad.

## Install the Showpad integration

Install Showpad from [Available integrations](https://app.truto.one/integrations/available/9c0f91b2-59e2-4d5b-bf90-e8e359baef6e) in each environment you connect accounts from.

## Create a Showpad OAuth app

Truto doesn't ship a Showpad OAuth app of its own, so bring yours. Until you set its Client ID and Client Secret on the installed integration, the connect UI doesn't list Showpad. See [Until the app is configured](/docs/guides/integrations/overriding-oauth-credentials#until-the-app-is-configured).

1. Sign in to Showpad as an administrator and open **Settings** → **Integrations** → **API** in the Admin App.
2. Click **Manage OAuth Clients**, then the **+** icon.
3. Fill in the **Name**, **Description** and **Website**. Enter the redirect URL below as the **Redirect URL**, and under **Scope** select the access the scopes below need. Click **Update**.
4. Showpad lists the client with its **Client ID** and **Secret**. Enter them as the Client ID and Client Secret on the installed Showpad integration; see [Overriding OAuth credentials](/docs/guides/integrations/overriding-oauth-credentials#steps-to-overriding-oauth).

See Showpad's [Authentication](https://developer.showpad.com/docs/apis/concepts/authentication) docs.

Redirect URL:

```text
https://api.truto.one/connect/showpad/callback
```

If you [use a redirect URL on your own domain](/docs/guides/integrations/overriding-oauth-credentials#use-a-redirect-url-on-your-own-domain), register that URL instead.

By default, Truto asks Showpad for these scopes. The connect screen lists them under **Permissions required**, and you can change them when you override the OAuth credentials.

- `read_user_management`

## Connect a Showpad account

1. Click **Connect Account**.
   ![Click Connect Account](https://docs-assets.truto.one/truto-connect-account.png)
2. Enter a Tenant ID. This can be any ID you choose. Click **Get connection link**.
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. Open the generated link. You can also share it with your customer so they connect their own Showpad account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select **Showpad**.
5. Fill in the form and click **Connect**:

   | Field | Required | What to enter |
   |---|---|---|
   | **Subdomain** | No | The first part of your Showpad URL, for example `acme`. The form doesn't enforce it, but the Showpad sign-in page is on this subdomain, so enter it. |
6. Sign in to Showpad and allow access.
7. Close the tab when you see the connection successful message. The new account appears under **Integrated Accounts**. Click its Account ID to see its details and make API calls.
