ChannelEngine: where can I find the ChannelName and ChannelID?
About this article
This article describes the ChannelName and ChannelID, how to locate them, and how they are used.
Table of contents
Every channel you add to your ChannelEngine environment has a name and an ID.
- ChannelName - the name of the channel within your environment.
- ChannelID - the unique ID of the channel within your environment.
The ChannelName is the name under which the channel is visible on the ChannelEngine dashboard. By default, it is similar to the global channel name, but you can change it under the Setup section of each channel. Fore more information on this, check out the ChannelEngine: setup article.
Most merchants do not change their channel names, but if you have multiple seller accounts you may want to change the channel name and channel image – so they differ from the global name and image.
The same applies to custom channels.
The ChannelID is visible in links and in the URL within specific channels on ChannelEngine. It changes incrementally with every channel you add. I.e.: if your first channel has an ID equal to 1, the second would be 2, and so on. If you remove a channel and re-add it later, it gains a new ChannelID.
- GlobalChannelName - the name of the channel across ChannelEngine.
- GlobalChannelId - the unique ID of the channel across ChannelEngine.
These identifiers come from a separate database, and cannot be changed by users. They are not visible in the web interface and can only be retrieved via the Merchant API.
When fetching orders via the
GET /v2/orders endpoint of the Merchant API, the channel identifiers are visible at the top of each individual order result.
In the example below, bol.com has a ChannelID equal to 2 for this merchant, while bol.com's GlobalChannelId is 76 on ChannelEngine.
"ChannelName": "bol.com Plaza NL (v2)",
"GlobalChannelName": bol.com Plaza NL (v3)",
Retrieve a complete list
A complete list of all available global and client-specific identifiers can be found by performing a
GET /v2/channels call via ChannelEngine's Merchant API
An excerpt of the first results from this call can be found below. In this case, Amazon.de is also enabled by the client and the channels array is filled with the client-specific ChannelIDs and ChannelNames. If the ChannelName is never changed, its value is null and the GlobalChannelName applies.