Store: Start Connection
start_store_connection[Store or Supplier Account]
[What it does] Installs one selected application if needed and generates its external authorization link. It supports seller applications for a new store connection and only AliExpress or Alibaba.com for adding a supplier account. A returned link does not mean the store or supplier account is connected.
[When to use] Use after the user selects a seller application, or explicitly asks to add an AliExpress or Alibaba.com supplier account.
[When not to use] For an existing seller store needing reconnection, use start_store_reauthorization. Other supplier applications cannot add accounts through this Tool.
[How to use] Provide exactly one identifier: copy recommend_apps_to_install.recommendations[].app_id into sales_channel_id for a seller application, or into supplier_platform_id only when that recommendation is AliExpress or Alibaba.com. An already-installed seller ID may also come from list_stores.stores[].sales_channel_id; an installed supplier ID may come from list_stores.supplier_apps[].supplier_platform_id. Never send both IDs. country is seller-only and should be passed only when that seller platform requires a country-specific flow. A successful response returns app_type, the matching sales_channel_id or supplier_platform_id, app_name, a validated HTTPS authorization_url, and generated_at; external authorization is still pending. The upstream platform controls URL lifetime and reuse. If the outcome is unresolved, verify seller connections or supplier accounts in DSers before retrying.
[Side effects] May install the selected seller, AliExpress, or Alibaba.com application.
[Confirmation] Requires explicit, non-skippable confirmation; show the selected application and country choice first.
[Follow-up] Give the returned authorization_url to the user to complete authorization on the platform, then verify the new connection in DSers.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_store_connection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Optional seller-platform country forwarded to authorization. Use only when the selected seller app requires it, such as a country-specific TikTok flow. Do not provide it for supplier accounts. | |
| sales_channel_id | No | Seller application ID returned by recommend_apps_to_install, or list_stores stores[].sales_channel_id for an installed platform. Provide exactly one of sales_channel_id and supplier_platform_id. | |
| supplier_platform_id | No | AliExpress or Alibaba.com supplier application ID returned by recommend_apps_to_install, or list_stores supplier_apps[].supplier_platform_id. Other supplier applications are rejected. Provide exactly one of supplier_platform_id and sales_channel_id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app_name | Yes | Selected application name | |
| app_type | Yes | Selected application type: seller or supplier | |
| generated_at | Yes | RFC3339 time when the authorization URL was generated | |
| sales_channel_id | No | Selected seller application ID as a decimal string; present only for seller connections | |
| authorization_url | Yes | External platform URL the user must open to authorize the new store | |
| supplier_platform_id | No | Selected AliExpress or Alibaba.com application ID as a decimal string; present only for supplier connections | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |