Store Groups API reference

Reference map for Store Groups API operations.

Updated
Apr 26, 2026

Store Groups

Use this reference map to choose the operation group before opening an endpoint page for exact request and response details.

Use Store Groups when the job is about selling context: a store group record and the markets attached to it.

Store group operations own listing, reads, creation, updates, deletion, adding markets, and removing markets. Store groups define pricing and availability settings across markets, while store-group market relationships carry pricing and tax configuration for that selling context.

Use Markets when the market record itself changes, Tax Groups when country-specific tax percentages are changing, and Variants or Customer Groups when prices are changing inside a store-group and market context. Check delete and remove-market operations before removing a store group or market because the contract documents dependency constraints.

For workflow guidance across store groups, markets, tax groups, warehouses, product drafts, variants, customer groups, and events, see Store groups and markets.

Read and inspect

OperationAPI
Get a store groupManagement API
List all store groupsManagement API

Create or attach

OperationAPI
Add a market to a store groupManagement API
Create a store groupManagement API

Update or repair

OperationAPI
Update a store groupManagement API

Remove or deactivate

OperationAPI
Delete a store groupManagement API
Remove a market from a store groupManagement API

Store Groups API reference

# Store Groups Use this reference map to choose the operation group before opening an endpoint page for exact request and response details. Use Store Groups when the job is about selling context: a store group record and the markets attached to it. Store group operations own listing, reads, creation, updates, deletion, adding markets, and removing markets. Store groups define pricing and availability settings across markets, while store-group market relationships carry pricing and tax configuration for that selling context. Use Markets when the market record itself changes, Tax Groups when country-specific tax percentages are changing, and Variants or Customer Groups when prices are changing inside a store-group and market context. Check delete and remove-market operations before removing a store group or market because the contract documents dependency constraints. For workflow guidance across store groups, markets, tax groups, warehouses, product drafts, variants, customer groups, and events, see [Store groups and markets](/start/concepts/store-groups-and-markets).

7 operations grouped by the job they support.

## Read and inspect | Operation | API | | --- | --- | | [Get a store group](/reference/storegroups/get-a-store-group) | Management API | | [List all store groups](/reference/storegroups/list-all-store-groups) | Management API | ## Create or attach | Operation | API | | --- | --- | | [Add a market to a store group](/reference/storegroups/add-a-market-to-a-store-group) | Management API | | [Create a store group](/reference/storegroups/create-a-store-group) | Management API | ## Update or repair | Operation | API | | --- | --- | | [Update a store group](/reference/storegroups/update-a-store-group) | Management API | ## Remove or deactivate | Operation | API | | --- | --- | | [Delete a store group](/reference/storegroups/delete-a-store-group) | Management API | | [Remove a market from a store group](/reference/storegroups/remove-a-market-from-a-store-group) | Management API |