For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
  • Overview
    • Quick Start
    • Sandboxes
    • Tools & SDKs
    • Support
  • Docs
      • Getting Started
      • Becoming a Partner
        • Introduction
        • Quick start
          • Types of apps
          • Building Catalyst-compatible apps and integrations
          • Beginning development
          • Managing apps in Dev Portal
          • Locating app IDs
          • Implementing OAuth
          • Handling callbacks
          • Supporting multiple users
          • Listening for events
          • Designing the UI
          • Creating install buttons
          • Following best practices
          • Approval requirements
          • Publishing apps
        • Optimizing multi-storefront apps
        • Building for Catalyst
      • Metafields
      • Scripts
      • Shipping Providers
      • Tax Providers
    • Archive
    • Closed Beta Programs
Dev Portal
LogoLogo
On this page
  • Find in control panel
  • Find in Developer Portal
  • Usage
  • Resources
DocsIntegrationsAppsGuide

Locating the ID of an APP

Was this page helpful?
Previous

Managing apps in Dev Portal

Next

Implementing OAuth

Built with

Select partners building channel apps need to know their app’s ID in order to create and modify the channel’s configuration. This tutorial demonstrates how to find an app’s ID in the Developer Portal and the control panel.

Find in control panel

An app’s ID can be found in the URL while on the app’s page in a store’s control panel. The location of the app’s page depends on if the app is installed or uninstalled.

  • Uninstalled Draft Apps: Apps > My Apps > My Draft Apps

  • Installed Apps: Apps > My Apps

To open the app page, click the app:

Draft App

The app ID is in the URL after /manage/marketplace/apps/:

Draft App ID

Find in Developer Portal

To find an app’s ID in the Developer Portal:

  1. Sign in to the Developer Portal.

  2. Click Edit App.

  3. Identify the app’s ID is in the URL (ex: /my/apps/{APP_ID}/summary?review=false).

Usage

Once you obtain the app ID, you can use it to create or modify the app configuration for a channel using the Create a channel or Update a channel endpoint.

Example request: Create a channel with app configuration
POST https://api.bigcommerce.com/stores/{STORE_HASH}/v3/channels
X-Auth-Token: {ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json
[{
"type": "type of channel",
"platform": "sales channel platform",
"name": "name of the sales channel",
"external_id": "",
"status": "connected",
"app": {
"id": 123, // ID of the app
"sections": [{
"title": "Overview",
"query_path": "overview"
}, {
"title": "Settings",
"query_path": "settings"
}]
}
}]

Resources

  • Building Apps Guide
  • Building Channel Apps
  • Extending Existing Apps with Channels Toolkit