Update Multiple Channels Currency Assignments | BigCommerce Developer Center

Updates enabled currencies and default currency for multiple channels. Note that currencies must be added first in the Settings > Setup > Currencies settings from an active MSF-enabled BigCommerce store control panel before the currencies can be assigned to a channel.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Channel Listings	modify	`store_channel_listings`
Channel Listings	read-only	`store_channel_listings_read_only`
Channel Settings	modify	`store_channel_settings`
Channel Settings	read-only	`store_channel_settings_read_only`
Sites & Routes	modify	`store_sites`
Sites & Routes	read-only	`store_sites_read_only`

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Channel Listings | modify | `store_channel_listings` | | Channel Listings | read-only | `store_channel_listings_read_only` | | Channel Settings | modify | `store_channel_settings` | | Channel Settings | read-only | `store_channel_settings_read_only` | | Sites & Routes | modify | `store_sites` | | Sites & Routes | read-only | `store_sites_read_only` | ### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

Request

This endpoint expects a list of objects.

channel_idlongRequired

The ID of the channel.

enabled_currencieslist of stringsRequired

Currencies that are enabled for the specified channel in ISO 4217 three character alphabetic format.

Currencies that are enabled for the specified channel in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) three character alphabetic format.

default_currencystringRequired

Default currency for the channel in ISO 4217 three character alphabetic format. Will be used on storefront when other currencies cannot.

Default currency for the channel in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) three character alphabetic format. Will be used on storefront when other currencies cannot.

Response

datalist of objects

metaobject

Response metadata.

Errors

422

Unprocessable Entity Error

OAuth scopes

UI Name	Permission	Parameter
Channel Listings	modify	`store_channel_listings`
Channel Listings	read-only	`store_channel_listings_read_only`
Channel Settings	modify	`store_channel_settings`
Channel Settings	read-only	`store_channel_settings_read_only`
Sites & Routes	modify	`store_sites`
Sites & Routes	read-only	`store_sites_read_only`

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

1	import requests
2
3	url = "https://api.bigcommerce.com/stores/store_hash/v3/channels/currency-assignments"
4
5	payload = [
6	{
7	"channel_id": 1,
8	"enabled_currencies": ["USD"],
9	"default_currency": "USD"
10	},
11	{
12	"channel_id": 664177,
13	"enabled_currencies": ["USD", "GBP"],
14	"default_currency": "USD"
15	},
16	{
17	"channel_id": 664179,
18	"enabled_currencies": ["USD", "AUD"],
19	"default_currency": "USD"
20	},
21	{
22	"channel_id": 667159,
23	"enabled_currencies": ["USD"],
24	"default_currency": "USD"
25	}
26	]
27	headers = {
28	"X-Auth-Token": "<apiKey>",
29	"Content-Type": "application/json"
30	}
31
32	response = requests.put(url, json=payload, headers=headers)
33
34	print(response.json())

1	{
2	"data": [
3	{
4	"channel_id": 1,
5	"enabled_currencies": [
6	"USD"
7	],
8	"default_currency": "USD"
9	},
10	{
11	"channel_id": 664177,
12	"enabled_currencies": [
13	"USD",
14	"GBP"
15	],
16	"default_currency": "USD"
17	},
18	{
19	"channel_id": 664179,
20	"enabled_currencies": [
21	"USD",
22	"AUD"
23	],
24	"default_currency": "USD"
25	},
26	{
27	"channel_id": 667159,
28	"enabled_currencies": [
29	"USD"
30	],
31	"default_currency": "USD"
32	}
33	],
34	"meta": {}
35	}