API ReferenceChannel accounts

Cette page n'est disponible qu'en anglais.

Choose the account to connect

POST /rest/v1/channel_connections/{id}/choose

POST
/channel_connections/{id}/choose

For a connection in needs_choice (the seller logged in and the channel has several accounts / marketplaces): connect the one in value. Show choices in your own UI, or let an agent pick. Within an hour of the seller's login, else 410 choice_expired. Requires channels:connect.

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

Unique client-generated key (max 255 chars), stored 24h.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/channel_connections/conn_66f0a1/choose" \  -H "Content-Type: application/json" \  -d '{    "value": "string"  }'
{  "id": "conn_66f0a1",  "object": "channel_connection",  "channel": "ebay",  "method": "oauth",  "status": "pending",  "choices": [    {      "value": "string",      "label": "string"    }  ],  "params": {},  "connect_url": "http://example.com",  "return_url": "string",  "channel_account_id": "string",  "error": {    "code": "channel_login_failed",    "message": "string"  },  "expires_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "reconnects_shop": "acme-vintage",  "import_products": true,  "import_orders": true,  "import_operation_id": "op_8fd2c1",  "completed_at": "2019-08-24T14:15:22Z"}

Dernière mise à jour le 14 octobre 2026

Besoin d'aide ?

Écrivez-nous et une personne vous répond, généralement sous un jour ouvré.