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

# Connect and Configure an App

> Connect your account in a tool with OAuth or API credentials, check the credential test result, and set the options of an installed app on its Configure tab.

## Connect an app

An official app sends data to a tool that has its own account, for example Slack or PostHog. You connect that account one time. Dodo Payments stores the connection and uses it to send data for you.

An app is **Connected**, **Not connected**, or **Connection needs attention**. The status shows in the **connection card** on the app page.

![The connection card of an official app with the status Not connected and the Connect button](https://mintcdn.com/dodopayments/kJYllb8bAFUjIS_F/images/app-marketplace/merchant/07-connection-card-not-connected.png?fit=max\&auto=format\&n=kJYllb8bAFUjIS_F\&q=85\&s=a648a242204f69c42c1bd04d5d6cddfe)

### Connection types

| Type | What you do | Example |
| - | - | - |
| OAuth | Sign in on the page of the tool. A new window opens. Dodo Payments does not see your password. | Slack |
| API credentials | Enter the credentials in the form. Dodo Payments stores them in an encrypted store. | PostHog, Mixpanel |

### Connect with OAuth

**1. Select Connect**

On the app page, select **Connect**. Only an owner or an admin can do this.

**2. Continue to the tool**

The dialog is titled **Connect** followed by the app name. Select **Continue to** followed by the app name. A new window opens.

![The Connect dialog of an OAuth app with the button Continue to the tool](https://mintcdn.com/dodopayments/kJYllb8bAFUjIS_F/images/app-marketplace/merchant/08-connect-dialog-oauth.png?fit=max\&auto=format\&n=kJYllb8bAFUjIS_F\&q=85\&s=09660c98202d8f554faf24ad375e530f)

If your browser blocks the window, allow pop-ups for the dashboard and try again. Select **Open window again** to reopen it.

**3. Approve in the tool**

Sign in to the tool and approve the access. For Slack, the window shows the permission page of the workspace. Choose the channel there, then select **Allow**. The card then shows **Connected** and the button **Update connection**.

### Connect with API credentials

**1. Select Connect**

On the app page, select **Connect**. A dialog opens on the dashboard page. No new window opens.

**2. Enter the credentials**

Fill in the form. Select **Where do I find this?** under a field to see where to find the value in the tool. Select **Show** to show a hidden value.

![The Connect dialog with the credential fields and the Where do I find this link](https://mintcdn.com/dodopayments/kJYllb8bAFUjIS_F/images/app-marketplace/merchant/09-connect-dialog-credentials.png?fit=max\&auto=format\&n=kJYllb8bAFUjIS_F\&q=85\&s=417ee99abc431fab5c64cebf712008aa)

**3. Select Connect**

Dodo Payments tests the credentials. The dialog shows **Checking the credentials…**.

### Credential test result

| Result | What you see | What to do |
| - | - | - |
| The tool accepts the credentials | The toast says that the app is connected. The status is **Connected**. | Nothing. |
| The tool refuses the credentials | An error, for example "The API key is not correct. Enter a correct key and try again." (PostHog) or "The credentials are not correct. Enter correct credentials and try again." (Mixpanel). The card stays **Not connected**. | Check the key or the credentials, then try again. |
| The test could not run | A warning: "Dodo Payments could not check this key. If no events arrive, update the connection." The connection is saved. | Send a test payment. If no event arrives, select **Update connection**. |

![The Connect dialog with the error message that the credentials are not correct](https://mintcdn.com/dodopayments/kJYllb8bAFUjIS_F/images/app-marketplace/merchant/10-connect-invalid-credentials.png?fit=max\&auto=format\&n=kJYllb8bAFUjIS_F\&q=85\&s=78fe85e009d98d244d3ba8f9553dc7b2)

If the status does not change after a minute, the card shows "The connection is not confirmed yet". Select **Refresh status**.

### Change or repair a connection

* To use other credentials, select **Update connection**.
* If the card says **Connection needs attention**, the tool stopped accepting the saved credentials. Select **Reconnect**. The app does not send data until you reconnect.

## Configure an app

Many apps have options that you can set. Open the app from the **Installed** tab. If the app has options, the page has two tabs: **Overview** and **Configure**. You can use the Configure tab before you connect the app.

![The Configure tab of an installed app with toggle fields, a product picker, and the Save bar](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/merchant/11-configure-tab.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=8f06b40170d1489026a8b9fabbe067af)

A red **Action needed** label on the tab means that a required value is missing or that a saved value is not valid now.

### Set the options

**1. Open the Configure tab**

Open the app, then select **Configure**.

**2. Change the values**

Fields can be text, numbers, switches, lists, and pickers for your products or currencies. A field can show a hint, for example a minimum or a maximum.

A secret field shows **Set** when it has a value. Select **Replace** to enter a new value, or **Remove** to delete it. The value is encrypted and is not shown again.

**3. Save**

A bar shows "You have unsaved changes". Select **Save**. The toast says **Settings saved**. Select **Discard** to drop the changes.

### Save behavior

* Changes apply when you save. The app is told about the change at once.
* Only an owner or an admin can save. Other members see the values, but not the secrets.
* You can install an app and skip the Configure step. The app then uses its default values until you save.
* If someone else saved while you edited, the page says "Settings changed. Review and save again". Your changes are kept. Check the values and save again.
* If the developer removed a field, your change to that field is dropped, and the page tells you which fields.
* The installation must be active to save. If the page says that the installation is not active, finish the install first.

You can change the settings at any time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.