create_marketplace
Create a new marketplace integration for a project from one of the channels in list_marketplace_channels. Use this when the user asks to add a marketplace. channel_code is the channelCode from list_marketplace_channels. Returns {integrationId, action:'create', status, kind:'marketplace', editUrl, nextStepType, message}. status is 'created' (the marketplace exists; continue with configure_marketplace_step starting at nextStepType) or 'prerequisite_not_met' (HTTP 409 — message explains what must be done first, e.g. an offer/primary feed must exist first, another marketplace is not included in this Koongo account (the message explains it), or the primary channel must be created first — see nextStepType). primary_sync marks this as the primary product source; order_sync enables order synchronization if the channel supports it; multichannel_code links a multichannel definition when the channel offers one (see get_marketplace_channel). definition_code picks a SPECIFIC definition of the channel when it has more than one (e.g. Amazon/Kaufland expose 'Offers' AND 'New Products') — take it from get_marketplace_channel definitions[].definitionCode; OMIT it to create the channel's default/primary definition. (versionType primary/secondary in get_marketplace_channel tells the definitions apart; it is NOT the same as primary_sync, which just marks this integration as the primary product source.) name is an OPTIONAL human-readable label so you can later find this marketplace by name (names are not unique — set_marketplace_name can change it later). project_id is OPTIONAL (inferred for a single-project customer; if project_id_required is returned, call list_projects).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"channel_code": "<channel_code>"
},
"name": "create_marketplace"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional human-readable name for the new marketplace. | |
| order_sync | No | Enable order synchronization (only if the channel supports it). | |
| project_id | No | ||
| channel_code | Yes | channelCode of the marketplace channel (from list_marketplace_channels). | |
| primary_sync | No | Mark this marketplace as the primary product source. | |
| definition_code | No | Pick a specific definition (definitionCode from get_marketplace_channel) when the channel has more than one, e.g. New Products vs Offers; omit for the default/primary definition. | |
| multichannel_code | No | Definition code of a multichannel option when the channel offers one. |