Get your API Client

Create an API Client for your Composable Commerce Project

Before your applications can interact with your Project, you must first set up an API Client.

API Clients include authentication information and permission scopes to determine what endpoints the API Client can interact with.

Objectives of this guide

By the end of this guide you will have:

Create an API Client

  1. Log in to the Merchant Center.

  2. Go to Settings > Developer settings.

    The Developer settings options in the Merchant Center

  3. Click Create new API client. The New API client page opens where you can configure the API client.

  4. Enter a name for your API. The name does not affect how the API functions.

    The API Client name

  5. Select what scopes your API Client uses. Use the drop-down list and choose Admin client to provide the API Client with complete access.

    The API Client scopes

  6. Click Create API client.

View your API Client configuration

Warning icon

API Client information is only displayed once.

Ensure that you save the project_key, client_id, secret, scope, API URL, and Auth URL before leaving or closing this page.

Your API Client information is listed under Client credential flow.

The client credential flow containing API Client settings

Save your API environment variables file

Not only can you can manually save your API Client information, but a drop-down list contains options for downloading your API Client configuration in a format-friendly way for various programming languages.

These configurations can be copied to your clipboard or downloaded.

  1. Select Environment Variables (.env) from the drop-down list and click the download icon.

    Environment Variables that can be downloaded

  2. The environment variables file is downloaded to your computer with a placeholder name based on your Project key and what you named the API Client (for example: project-key_API client name.env).

    Information icon

    The environment variables file is a plain text file and can be opened with any text or code editor.

  3. Open your downloads folder and rename the environment variables file .env.