Choose the account to connect
POST /rest/v1/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.
Authorization
apiKey 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
Header Parameters
Unique client-generated key (max 255 chars), stored 24h.
length <= 255Request 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"}Last updated on October 14, 2026
Need help?
Email us and a human replies, usually within one business day.