Skip to main content
PUT
/
api
/
v1
/
shop.json
Update Shop
curl --request PUT \
  --url https://api.launchmystore.io/api/v1/shop.json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "address": {
    "address1": "<string>",
    "address2": "<string>",
    "city": "<string>",
    "province": "<string>",
    "province_code": "<string>",
    "country": "<string>",
    "country_code": "<string>",
    "zip": "<string>"
  },
  "currency": "<string>",
  "money_format": "<string>",
  "money_with_currency_format": "<string>",
  "timezone": "<string>",
  "weight_unit": "<string>",
  "password_enabled": true,
  "password": "<string>",
  "taxes_included": true,
  "tax_shipping": true,
  "enabled_presentment_currencies": [
    {}
  ]
}
'
{
  "success": true,
  "data": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Update Shop

Updates the shop’s settings. Only provided fields will be updated.

​
Request

curl -X PUT "https://api.launchmystore.io/api/v1/shop.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Awesome Store - Rebranded",
    "email": "support@mystore.com",
    "phone": "+1 (555) 987-6543"
  }'

​
Body Parameters

All parameters are optional. Only provided fields will be updated.
​
name
string
Shop name
​
email
string
Shop contact email
​
phone
string
Shop phone number
​
address
object
Shop address
​
currency
string
Primary currency code (e.g., “USD”, “EUR”, “GBP”)
​
money_format
string
Money format string. Use {{amount}} as placeholder.
​
money_with_currency_format
string
Money format with currency. Use {{amount}} as placeholder.
​
timezone
string
IANA timezone identifier (e.g., “America/New_York”)
​
weight_unit
string
Weight unit: kg, g, lb, oz
​
password_enabled
boolean
Enable/disable storefront password protection
​
password
string
Storefront password (only when password_enabled is true)
​
taxes_included
boolean
Whether prices include tax
​
tax_shipping
boolean
Whether shipping is taxable
​
enabled_presentment_currencies
array
Array of currency codes to enable for multi-currency

​
Response

​
success
boolean
Whether the request succeeded
​
data
object
The updated shop object

​
Example Response

{
  "success": true,
  "data": {
    "id": "shop_abc123",
    "name": "My Awesome Store - Rebranded",
    "email": "support@mystore.com",
    "domain": "mystore.com",
    "mylaunchmystore_domain": "mystore.launchmystore.io",
    "phone": "+1 (555) 987-6543",
    "address": {
      "address1": "123 Commerce St",
      "address2": "Suite 100",
      "city": "San Francisco",
      "province": "California",
      "province_code": "CA",
      "country": "United States",
      "country_code": "US",
      "zip": "94102"
    },
    "currency": "USD",
    "money_format": "${{amount}}",
    "money_with_currency_format": "${{amount}} USD",
    "timezone": "(GMT-08:00) Pacific Time (US & Canada)",
    "iana_timezone": "America/Los_Angeles",
    "weight_unit": "lb",
    "plan_name": "professional",
    "plan_display_name": "Professional",
    "password_enabled": false,
    "taxes_included": false,
    "tax_shipping": false,
    "enabled_presentment_currencies": ["USD", "CAD", "EUR", "GBP"],
    "created_at": "2023-01-15T10:00:00Z",
    "updated_at": "2024-03-20T16:45:00Z"
  }
}

​
Notes

  • Changing currency does not convert existing prices - update products separately
  • domain cannot be changed via API - use the dashboard to manage domains
  • Plan changes must be done through the billing dashboard

​
Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have write_shop scope
VALIDATION_ERRORInvalid request body (see error details)