This guide will show you how to create your public app. To learn how to authenticate your app, click here.

Overview

In order to access Wish data through the merchant API, you must first register a public app. This app will have to be authenticated using the OAuth 2.0 specification. At this time, you are only allowed to have one public app.

NOTE: If you are a merchant and want to create an application only for yourself, learn about how to create a private app here. Private apps cannot be shared among multiple merchants.

Creating your first app

To create your first app, log in to your merchant dashboard and select the Account dropdown menu. Then select Create App.

You will be redirected to a page with a form shown below. Here you can fill out information about your new app.

The redirect URI is an endpoint that is owned by you. This will be the URI to which we send the authorization code. This URI must use HTTPS. For more information on how this endpoint will be used, click here.

The other details that you provide on this form will be displayed in the official merchant app directory where merchants can browse for apps like yours. The fields that merchants will see are Value proposition, Description, Website, and Support email. If you do not provide sufficient information, your app may not qualify to be listed in the app directory. If you want to make sure your app is shown in the app directory, make sure to at least provide a website and description.

For information about adding translated listings, please see the Adding translated listings section below.

View details about your app

After you create your app, you will be redirected to the show page where you can see details of the app you just created. You can also access this page directly by going to Account > App Settings:
From this page, you can also click the appropriate button to edit or delete the app.

This page provides a preview of what your app listing will look like in the official app directory.

Note: if you update your app and the update is rejected, you might see a third button on this screen called Continue previous revision as shown below. Clicking this allows you to edit the app with the details from your last submission pre-filled.

Updating your app

From the show page you can click Edit app listing to go to the update page. You can update any fields except the app name.

Remember, if you do not provide sufficient information, your app may not qualify to be listed in the official app directory.

For information about adding translated listings, please see the Adding translated listings section below.

Adding translated listings

You can add translated listings for your app on either the create or edit page. The appropriate translated listing for your app will appear for merchants based on their regional language settings.

On either of those pages, click the Add translated listing button under Listing Language.

A window will appear where you can select a language.

After you select a language, you will be redirected to a simplified form where you can add the appropriate details for that language.

After saving your changes, you will be able to see the translated listings on the show page by selecting the language from the dropdown menu.

If you want to view/edit these translated listings later, you will be able to see the languages that have translated listings in the Listing Language drop down menu on either the create or edit page.