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

# Create an App

> Create an app in the Dodo Payments dashboard: set the name, the logo, the categories, the summary, the redirect URLs, the scopes, the webhooks, and the testers.

## Before you start

* You need write access to API keys in the business that owns the app.
* Plan the redirect URLs, the scopes, and the reason for each scope. Merchants read the reasons on the consent screen.

## Create the app

**1. Open the Created tab**

In the dashboard at [app.dodopayments.com](https://app.dodopayments.com), open **Apps**, select the **Created** tab, and select **Create app**.

![The Created tab with no apps and the Create app button](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/developer/01-created-tab-empty.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=6f892c7517467447e588c85acbccab6a)

**2. Fill in the app basics**

The wizard is titled **Register a new app**. Step 1 is **App basics**.

| Field | Rule |
| - | - |
| **App name** | 1 to 100 characters. A name that starts with "Dodo" is reserved for official apps. |
| **Categories** | One or two. Examples: Accounting, Analytics, Billing, Communication, CRM, Developer tools. |
| **Summary** | One line, up to 200 characters. It shows on the app card. |
| **Logo**, **Website**, **Support email**, **Description** | Optional now. You need them to list the app. |

![Step 1 of the Register a new app wizard with the app name Acme Alerts, two categories, and the summary field](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/developer/02-wizard-app-basics.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=f6b322de3b0de29d9b1d256372f9a9e9)

**3. Choose the access and the redirect URLs**

Step 2 is **Access and permissions**. Select the scopes that the app needs. Each resource has the level **None**, **Read**, or **Write**.

Add 1 to 10 **OAuth redirect URLs**. Dodo Payments sends the merchant to one of them after the install. Each URL must use `https` and cannot contain `#`.

![Step 2 of the wizard with the OAuth redirect URL and the access and permissions list](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/developer/03-wizard-permissions.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=768739779d6cf6977ac92b858b60eaf2)

> [!WARNING]
>
> Request only the scopes that the app uses. Scopes for money movement and customer data get extra attention in review.

**4. Set the webhooks**

Step 3 is for **Webhook endpoints** and **Webhook events**. Both are optional.

* **Live endpoint**: live installs send events here.
* **Test endpoint**: test installs send events here. With no URL, test installs send no events.
* **Webhook events**: you can select only the events that a selected scope covers. The form does not accept events without a webhook URL. It shows "Enter a webhook URL to get the selected events."

![Step 3 of the wizard with the live endpoint, the test endpoint, and the events payment.succeeded, payment.failed, and payment.processing selected](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/developer/04-wizard-webhooks.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=e8082572ea5d050bbd1f52819361148d)

**5. Create the app and copy the credentials**

Select **Create app**. The **Credentials** dialog shows the **Client ID** and the **Client secret**. Copy the secret now. It shows only one time.

![The credentials dialog with the client ID and the masked client secret](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/developer/05-credentials-dialog.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=00653221f0450544abd203ac3cfa5eed)

If you lose the secret, rotate it on the app page.

Every new app is private. Only your business and your testers can install it.

## The app page

Open the app from the **Created** tab. The page has four tabs.

| Tab | Content |
| - | - |
| **Overview** | The client ID, the client secret (rotate it here), the publisher, and the status. |
| **Integrate** | The authorization URL, the token URL, the API base URL of the current mode, the scopes, and example requests. |
| **Configuration** | The redirect URIs, the webhook endpoints, the scopes, the events, and the settings manifest. |
| **Testing** | The test link and the testers. |

![The Overview tab of an app that you created, with the client ID and the Rotate secret button](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/developer/06-owner-app-overview.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=fb8aa629ec1f2ddec8b216f99beba378)

### Listing details

Open the listing fields with **Edit**, or in the **Make public** wizard. These fields are needed for the review:

| Field | Notes |
| - | - |
| Summary and **Description** | The description supports Markdown. |
| **App icon** | PNG or JPG, up to 5 MB. A square image works best. |
| **Screenshots** | Recommended. PNG or JPG, up to 5 MB each. 16:9 works best. |
| **Website URL**, **Documentation URL** | `https` URLs. |
| **Terms of service URL**, **Privacy policy URL** | Needed for review. |
| **Support email** | Needed for review. |
| **Install URL** | Merchants who select **Install** go here. Your app then starts the OAuth flow. **Make public** needs an install URL. |

### Scopes and reasons

Write a reason for each requested scope. The consent screen shows the reason to the merchant. A review needs a reason for each scope.

### Rotate the secret and revoke tokens

* **Rotate secret**: the old secret stops working at once. Update your servers first.
* **Revoke access tokens** (in the Danger zone card on the **Configuration** tab): revokes every token of the app. Each merchant loses access within 2 minutes, and each install gets `app.uninstalled`.
* **Delete app**: removes the app from every business that installed it.

![The Danger zone card on the Configuration tab with the Revoke access tokens and Delete app actions](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/developer/07-owner-danger-zone.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=fa3afb086fb896a6d630ea3d1a135b7c)

## Add testers

Open the **Testing** tab. Select **Create test link** and share the link. Up to 25 other businesses can join and install the app before it is public. Select **New link** to stop new joins with the old link. Businesses that joined stay testers. Select **Remove** to remove a tester. See [Test your app](https://docs.dodopayments.com/developer-resources/apps/test-your-app.md).

![The Testing tab with the test link and Testers: 0 of 25](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/developer/08-testing-tab-test-link.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=37f98ca6573dd4637b7f383cf5fd615d)

## Edit a live app

When you edit a live app, changes to the listing, the permissions, the redirect URIs, and the webhooks go to review. The live version stays until approval. See [Submit for review and publish](https://docs.dodopayments.com/developer-resources/apps/submit-for-review.md#change-a-live-app).


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