Skip to main content
PUT
Update Shop
This endpoint is part of the merchant Admin API and is authenticated with a merchant access token (not an app OAuth access token). The OAuth App API exposes the store read-only via GET /api/v1/shop.json; there is no app-scoped shop-update endpoint.

Update Shop

The OAuth App API is read-only for the shop resource — there is no PUT /api/v1/shop.json. To read shop details over the App API, use Get Shop (GET /api/v1/shop.json, scope read_shop). Shop / business settings are updated through the merchant dashboard API using a merchant (or staff) JWT, not an OAuth app access token. The relevant endpoint is PUT /account/add-business-detail. Only the fields you send are updated.

Request

Body Parameters

All parameters are optional. Only provided fields will be updated.
business
string
Business / shop name.
businessEmail
string
Business contact email.
phone
string
Business phone number.
ownerName
string
Store owner’s name.
category
string
Store category.
country
string
Store country. Currency is auto-resolved from the store’s country.
storeAdd
string
Store address.
gstNumber
string
Tax / GST registration number.
availableCountries
array
Countries the store ships to / supports (e.g. ["India", "United States"]).
availableLanguages
array
Supported language codes (e.g. ["en", "es", "fr"]).
defaultLanguage
string
Default storefront language code (e.g. "en").
useManualExchangeRates
boolean
Use manually-entered exchange rates instead of live API rates.
manualExchangeRates
object
Manual exchange rate map keyed by currency code, based on the store’s default currency (e.g. { "USD": 1.0, "EUR": 0.92, "INR": 83.12 }).
currencyConversionFee
number
Currency conversion fee percentage (0–10).
The store logo is updated via the separate PUT /account/add-business-logo endpoint (multipart upload).

Response

Responses use the platform response envelope: status, state, message, data.

Notes

  • Currency is auto-resolved from the store’s country; there is no standalone currency field on this endpoint.
  • Domains and plan / billing changes are managed in the dashboard, not via this endpoint.