LogoLogo
Build appsContact API support
  • Build apps
  • Site Templates
  • API Reference
  • Changelog
  • REST API
    • REST API overview
    • Store Profile
      • Get store profile
      • Update store profile
      • Upload store logo image
      • Delete store logo image
      • Store reports
        • Get store reports
        • Get latest store update stats
        • Get deleted items history
    • Orders
      • Search orders
      • Get order
      • Get last order
      • Calculate order details
      • Update order
      • Create order
      • Delete order
      • Get repeat order URL
      • Order invoices
        • Get order receipt PDF
        • Get tax invoices for order
        • Generate tax invoice for order
      • Order statuses
        • Search order statuses
        • Get order status
        • Update custom order status
      • Order extra fields
        • Search order extra fields
        • Update order extra field
        • Add extra fields to order
        • Delete order extra field
      • Abandonned carts
        • Search abandoned carts
        • Get abandoned cart
        • Update abandoned cart
        • Convert abandoned cart to order
      • Recurring subscriptions
        • Search recurring subscriptions
        • Get recurring subscription
        • Update recurring subscription
    • Products
      • Search products
      • Get product
      • Update product
      • Create product
      • Delete product
      • Delete all products
      • Adjust product stock
      • Get product filters
      • Get recently used product swatches
      • Search product brands
      • Product images and videos
        • Upload main product image
        • Upload main product image (async)
        • Upload gallery product image
        • Upload gallery product image (async)
        • Delete main product image
        • Delete gallery product image
        • Delete all gallery product images
        • Upload main product video
        • Upload gallery product video
        • Upload cover for gallery video
        • Delete main product video
        • Delete gallery product video
        • Download gallery product video
        • Bulk update product images and videos
      • Product files
        • Upload product file
        • Download product file
        • Delete product file
        • Delete all product files
        • Change product file description
      • Product variations
        • Search product variations
        • Get product variation
        • Update product variation
        • Create product variation
        • Delete product variation
        • Delete all product variations
        • Adjust product variation stock
        • Upload product variation image
        • Upload product variation image (async)
        • Delete product variation image
      • Product types and attributes
        • Search product types
        • Get product type
        • Update product type and attributes
        • Create product type
        • Delete product type
      • Product reviews
        • Search product reviews
        • Get product reviews stats
        • Update product review status
        • Bulk update/delete product reviews
        • Delete product review
    • Categories
      • Search categories
      • Search categories by path
      • Get category
      • Update category
      • Create category
      • Delete category
      • Category images
        • Upload category image
        • Upload category image (async)
        • Delete category image
      • Manage order of categories in the store
        • Get order of categories
        • Update order of categories
      • Manage order of products in the category
        • Get order of products
        • Update order of products
        • Assign products to the category
        • Unassign products from the category
    • Customers
      • Search customers
      • Get customer
      • Update customer
      • Create customer
      • Delete customer
      • Customer groups
        • Search customer groups
        • Get customer group
        • Update customer group name
        • Create customer group
        • Delete customer group
      • Customer contacts
        • Search customer contacts
        • Get customer contact
        • Update customer contact
        • Create customer contact
        • Delete customer contact
      • Customer extra fields
        • Search customer extra fields
        • Get customer extra field
        • Update customer extra field
        • Create customer extra field
        • Delete customer extra field
    • Discounts
      • Promotions
        • Search promotions
        • Update promotion
        • Create promotion
        • Delete promotion
      • Discount coupons
        • Search discount coupons
        • Get discount coupon
        • Update discount coupon
        • Create discount coupon
        • Delete discount coupon
    • Domains
      • Search store domains
      • Update store domains
      • Search domains for purchase
      • Purchase domain
      • Send domain verification email
      • Reset domain password
    • Dictionaries
      • Country codes
      • Currency codes
      • Currency codes by country
      • State codes by country
      • Tax classes by country
    • Staff accounts
      • Search staff accounts
      • Get staff account
      • Get staff account scopes
      • Update staff account
      • Create staff account
      • Delete staff account
      • Resend staff account invite
      • Cancel staff account invite
    • Application
      • Get app subscription status
      • Cancel app subscription
      • Get all app storage data
      • Get specific app storage data
      • Update specific app storage data
      • Delete specific app storage data
      • Add app storage data
      • Custom charge with Ecwid billing
    • Batch requests
      • Create batch request
      • Get batch status
      • Search batch requests by status
      • Stop batch request
      • Stop and delete batch request
    • Shipping options
      • Search shipping options
      • Update shipping option
      • Create shipping option
      • Delete shipping option
    • Payment options
      • Search payment options
      • Get payment option
      • Update payment option
      • Create payment option
      • Delete payment option
    • Checkout extra fields
      • Add checkout extra fields with JavaScript
      • Manage checkout extra fields with REST API
        • Search checkout extra fields
        • Get checkout extra field
        • Update checkout extra field
        • Create checkout extra field
        • Delete checkout extra field
    • Storefront widget details
      • Get page slug and static code
      • Set base URL for storefront widgets
      • Optimize custom website SEO with better URLs
        • Enable Clean Store URLs on a custom website
        • Set Custom Page Slugs on a custom website
      • Dynamic loading for storefront widget
      • SSO (Single-Sign-On) for websites
        • Add SSO to the website
        • Customize SSO on the website
        • SSO code examples
      • Static store pages
        • Static code for home page
        • Static code for category page
        • Static code for product page

Lightspeed® 2025

On this page
  • Required access scopes
  • Path params
  • Query params
  • Headers
  • Request JSON
  • Response JSON

Was this helpful?

  1. REST API
  2. Store Profile

Update store profile

Update main store settings, for example: store location, available languages, contact info, etc.

PUT https://app.ecwid.com/api/v3/{storeId}/profile

Request and response example

Request:

curl --location --request PUT 'https://app.ecwid.com/api/v3/1003/profile' \
--header 'Authorization: Bearer secret_ab***cd
--data '{
    "company": {
        "phone": "+79876543210"
    }
}'

Response:

{
    "updateCount": 1
}

Required access scopes

Your app must have the following access scopes to make this request: update_store_profile

Path params

Param
Type
Description

storeId

number

Ecwid store ID.

Query params

All query params are optional.

Name
Type
Description

showExtendedInfo

boolean

Set true to receive additional store profile data including account/billing data. Requires read_store_profile_extended access scope.

lang

string

Language ISO code for translations in JSON response, e.g. en, fr. Translates fields like: title, description, pickupInstruction, text, etc.

responseFields

string

Specify the exact fields to receive in response JSON. If not specified, the response JSON will have all available fields for the entity. Example: ?responseFields=generalInfo(storeId,storeUrl)

Example of using responseFields param:

curl --location 'https://app.ecwid.com/api/v3/1003/profile?responseFields=generalInfo(storeId,storeUrl)' \
--header 'Authorization: Bearer secret_ab***cd'
{
    "generalInfo": {
        "storeId": 1003,
        "storeUrl": "https://store1003.company.site/"
    }
}

Headers

The Authorization header is required.

Header
Format
Description

Authorization

Bearer secret_ab***cd

Access token of the application.

Request JSON

A JSON object with the following fields:

Field
Type
Description

generalInfo

Basic data about Ecwid store: ID, website URL, website platform, Instant Site settings.

account

Store owner's account details.

settings

Store general settings.

mailNotifications

Mail notifications settings.

phoneNotifications

Phone notifications settings.

company

Information about physical store: company name, phone, address.

formatsAndUnits

Store formats/untis settings.

languages

Store language settings.

shipping

Store shipping settings.

zones

List of store destination zones.

taxes

List of store taxes.

taxSettings

Detailed settings for store taxes.

businessRegistrationID

Company registration ID, e.g. VAT reg number or company ID, which is set under Settings / Invoice in Control panel

legalPagesSettings

Legal pages settings for a store (System Settings → General → Legal Pages).

designSettings

Design settings of an Ecwid store. Can be overriden by updating store profile or by customizing design via JS config in storefront.

productFiltersSettings

Settings for product filters in a store.

orderInvoiceSettings

Store settings for order invoices.

socialLinksSettings

Store settings for social media accounts.

registrationAnswers

Merchants' answers provided while registering their Ecwid accounts.

tipsSettings

Store settings for tips.

generalInfo

Field
Type
Description

storeUrl

string

Main website URL.

starterSite

websitePlatform

string

Website platform that store is added to. Possible values: "wix", "wordpress", "iframe", "joomla", "yola", etc. Default is "unknown".

account

Field
Type
Description

accountName

string

Full store owner name

settings

Field
Type
Description

closed

boolean

true if the store is closed for maintenance, false otherwise

storeName

string

The store name displayed in Instant Site

storeDescription

string

HTML description for the main store page – Store Front page

googleRemarketingEnabled

boolean

true if Remarketing with Google Analytics is enabled, false otherwise

googleAnalyticsId

string

fbPixelId

string

orderCommentsEnabled

boolean

true if order comments feature is enabled, false otherwise

orderCommentsCaption

string

Caption for order comments field in storefront

orderCommentsCaptionTranslated

Available translations for the caption for order comments field.

orderCommentsRequired

boolean

true if order comments are required to be filled, false otherwise

askZipCode

boolean

true if the zip code field is shown on the checkout ('Ask for a ZIP/postal code' in checkout settings is enabled), false otherwise

showPricePerUnit

boolean

true if the "Show price per unit" option is turned on, otherwise false

hideOutOfStockProductsInStorefront

boolean

true if out of stock products are hidden in storefront, false otherwise. This setting is located in Ecwid Control Panel > Settings > General > Cart

askCompanyName

boolean

true if "Ask for the company name" in checkout settings is enabled, false otherwise

favoritesEnabled

boolean

true if favorites feature is enabled for storefront, false otherwise

productReviewsFeatureEnabled

boolean

true if product reviews feature is enabled in the store, false otherwise.

defaultProductSortOrder

string

Default products sort order setting from Settings > Cart & Checkout. Possible values: "DEFINED_BY_STORE_OWNER", "ADDED_TIME_DESC", "PRICE_ASC", "PRICE_DESC", "NAME_ASC", "NAME_DESC"

abandonedSales

Abandoned sales settings

salePrice

Sale (compare to) price settings

showAcceptMarketingCheckbox

boolean

true if merchant shows the checkbox to accept marketing. false otherwise

acceptMarketingCheckboxDefaultValue

boolean

Default value for the checkbox at checkout to accept marketing

acceptMarketingCheckboxCustomText

string

Custom text label for the checkbox to accept marketing at checkout

acceptMarketingCheckboxCustomTextTranslated

Available translations for custom text label for the checkbox to accept marketing at checkout.

askConsentToTrackInStorefront

boolean

true if merchant shows warning to accept cookies in storefront. false otherwise

snapPixelId

string

pinterestTagId

string

googleTagId

string

googleEventId

string

recurringSubscriptionsSettings

Recurring subscription settings information.

allowPreordersForOutOfStockProducts

boolean

true if pre-orders for out of stock products are allowed, false otherwise.

linkUpEnabled

boolean

mailNotifications

Field
Type
Description

adminNotificationEmails

Array of strings

Email addresses, which the store admin notifications are sent to

customerNotificationFromEmail

string

The email address used as the 'reply-to' field in the notifications to customers

customerOrderMessages

Settings for email notifications that are automatically sent to customers to confirm their orders and keep them informed about the order progress

adminMessages

Settings for email notifications that are automatically sent to the store owner and staff members

customerMarketingMessages

Settings for email notifications that are automatically sent to customers to engage them and increase store sales

customerOrderMessages

Field
Type
Description

orderConfirmation

Settings for Order confirmation emails. Supported settings: enabled, marketingBlockEnabled, discountCouponId

orderStatusChanged

Settings for Order status changed emails. Supported settings: enabled

orderIsReadyForPickup

Settings for Order is ready for pickup emails. Supported settings: enabled

downloadEgoods

Settings for Download e-goods emails. Supported settings: enabled

orderShipped

Settings for Order shipped emails. Supported settings: enabled

adminMessages

Field
Type
Description

newOrderPlaced

Settings for New order placed emails. Supported settings: enabled

lowStockNotification

Settings for Low stock notification emails. Supported settings: enabled

weeklyStatsReport

Settings for weekly stats reports. Supported settings: enabled

customerMarketingMessages

Field
Type
Description

abandonedCartRecovery

Settings for Order confirmation emails. Supported settings: enabled, marketingBlockEnabled, discountCouponId

favoriteProductsReminder

Settings for Order status changed emails. Supported settings: enabled, discountCouponId

feedbackRequest

Settings for Order is ready for pickup emails. Supported settings: enabled, discountCouponId

customerLoyaltyAppreciation

Settings for Order confirmation emails. Supported settings: enabled, discountCouponId

inactiveCustomerReminder

Settings for Order status changed emails. Supported settings: enabled, discountCouponId

purchaseAnniversary

Settings for Order is ready for pickup emails. Supported settings: enabled, discountCouponId

MailNotificationsSettings

Field
Type
Description

enabled

boolean

true if emails are enabled, false otherwise

marketingBlockEnabled

boolean

true if the marketing block for emails is enabled, false otherwise

discountCouponId

number

id of the discount coupon added to emails

phoneNotifications

Field
Type
Description

adminNotificationPhones

Array of strings

Phone numbers that are used for store admin notifications, supports up to 100 phone numbers (for future usage).

recurringSubscriptionsSettings

Field
Type
Description

showRecurringSubscriptionsInControlPanel

boolean

true if recurring subscriptions feature is visible in admin panel, false otherwise.

company

Field
Type
Description

companyName

string

The company name displayed on the invoice

email

string

Company (store administrator) email

street

string

Company address. 1 or 2 lines separated by a new line character

city

string

Company city

countryCode

string

A two-letter ISO code of the country

postalCode

string

Postal code or ZIP code

stateOrProvinceCode

string

State code (e.g. NY) or a region name.

phone

string

Company phone number

formatsAndUnits

Field
Type
Description

currency

string

3-letters code of the store currency (ISO 4217). Examples: USD, CAD

currencyPrefix

string

Currency prefix (e.g. $)

currencySuffix

string

Currency suffix

currencyPrecision

number

Numbers of digits after decimal point in the store prices. E.g. 2 ($2.99) or 0 (¥500).

currencyGroupSeparator

string

Price thousands separator. Supported values: space " ", dot ".", comma "," or empty value "".

currencyDecimalSeparator

string

Price decimal separator. Possible values: . or ,

currencyTruncateZeroFractional

boolean

Hide zero fractional part of the prices in storefront. true or false .

currencyRate

number

Currency rate in U.S. dollars, as set in the merchant control panel

weightUnit

string

Weight unit. Supported values: CARAT, GRAM, OUNCE, POUND, KILOGRAM

weightPrecision

number

Numbers of digits after decimal point in weights displayed in the store

weightGroupSeparator

string

Weight thousands separator. Supported values: space " ", dot ".", comma "," or empty value ""

weightDecimalSeparator

string

Weight decimal separator. Possible values: . or ,

weightTruncateZeroFractional

boolean

Hide zero fractional part of the weight values in storefront. true or false .

dateFormat

string

Date format. Only these formats are accepted: "dd-MM-yyyy", "dd/MM/yyyy", "dd.MM.yyyy", "MM-dd-yyyy", "MM/dd/yyyy", "yyyy/MM/dd", "MMM d, yyyy", "MMMM d, yyyy", "EEE, MMM d, ''yy", "EEE, MMMM d, yyyy"

timeFormat

string

Time format. Only these formats are accepted: "HH:mm:ss", "HH:mm", "hh.mm.ss a", "hh:mm a"

timezone

string

Store timezone, e.g. Europe/Moscow

dimensionsUnit

string

Product dimensions units. Supported values: MM, CM, IN, YD

orderNumberPrefix

string

Prefix for the order ID. Max length: 20 symbols. For example, if a prefix is "01_", then order ID "XGX7J" becomes "01_XGX7J" in all customer nofications and in Ecwid admin.

orderNumberSuffix

string

Suffix for the order ID. Max length: 20 symbols. For example, if a suffix is "_25", then order ID "XGX7J" becomes "XGX7J_25" in all customer nofications and in Ecwid admin.

orderNumberMinDigitsAmount

number

Minimum digits amount of an order number (can be 0-19 digits).

orderNumberNextNumber

number

Next order number in a store (should be more than 0).

addressFormat

Address format: plain and multiline formats. Displays the way address is written according to the requirements of the country set up in the profile settings. Supports the following variables: %NAME%, %COMPANY_NAME%, %STREET%, %CITY%, %STATE_NAME% %POSTAL%, %COUNTRY_NAME%.

addressFormat

Field
Type
Description

plain

string

Single line address format, with a delimiter.

multiline

string

Multiline address format.

languages

Field
Type
Description

enabledLanguages

Array of strings

A list of enabled languages in the storefront. First language code is the default language for the store.

defaultLanguage

string

ISO code of the default language in store

shipping

Field
Type
Description

handlingFee

Handling fee settings

shippingOrigin

Shipping origin address. If matches company address, company address is returned. Available in read-only mode only

shippingOptions

Details of each shipping option present in a store. For public tokens enabled methods are returned only. Available in read-only mode only

handlingFee

Field
Type
Description

name

string

Handling fee name set by store admin. E.g. Wrapping

value

number

Handling fee value

description

string

Handling fee description for customer

shippingOrigin

Field
Type
Description

companyName

string

The company name displayed on the invoice

email

string

Company (store administrator) email

street

string

Company address. 1 or 2 lines separated by a new line character

city

string

Company city

countryCode

string

A two-letter ISO code of the country

postalCode

string

Postal code or ZIP code

stateOrProvinceCode

string

State code (e.g. NY) or a region name

phone

string

Company phone number

taxSettings

Field
Type
Description

automaticTaxEnabled

boolean

true if store taxes are calculated automatically, else otherwise. As seen in the Ecwid Control Panel > Settings > Taxes > Automatic

taxes

Manual tax settings for a store

pricesIncludeTax

boolean

true if store has "gross prices" setting enabled. false if store has "net prices" setting enabled.

taxExemptBusiness

boolean

Defines if your business is tax-exempt under § 19 UStG. When true, it will display the “Tax exemption § 19 UStG” message to customers to explain the zero VAT rate.

ukVatRegistered

boolean

If true and order is sent from EU to UK - charges VAT for orders less than GBP 135.

euIossEnabled

boolean

If true and order is sent to EU - charges VAT for orders less than EUR 150. For Import One-Stop Shop (IOSS).

taxOnShippingCalculationScheme

string

Shipping tax calculation schemes. Default value: AUTOMATIC. Possible values: AUTOMATIC, BASED_ON_PRODUCT_TAXES_PROPORTION_BY_PRICE, BASED_ON_PRODUCT_TAXES_PROPORTION_BY_WEIGHT, TAXED_SEPARATELY_FROM_PRODUCTS

taxes

Field
Type
Description

id

number

Unique internal ID of the tax

name

string

Displayed tax name

enabled

boolean

Whether tax is enabled true / false

includeInPrice

boolean

useShippingAddress

boolean

true if the tax is calculated based on shipping address, false if billing address is used

taxShipping

boolean

true is the tax applies to subtotal+shipping cost . false if the tax is applied to subtotal only

appliedByDefault

boolean

true if the tax is applied to all products. false is the tax is only applied to thos product that have this tax enabled

defaultTax

number

Tax value, in %, when none of the destination zones match

rules

Tax rates

rules

Field
Type
Description

zoneId

string

Destination zone ID

tax

number

Tax rate for this zone in %

zones

Field
Type
Description

name

string

Zone displayed name.

countryCodes

Array of strings

Country codes this zone includes .

stateOrProvinceCodes

Array of strings

State or province codes the zone includes.

postCodes

Array of strings

geoPolygons

geoPolygons

Field
Type
Description

<COORDINATES>

Array of arrays

Each array contains coordinates of a single dot of the polygon. (E.g. [ [37.036539581171105, -95.66864041664617], [37.07548018723009, -95.6404782452158], ...]).

businessRegistrationID

Field
Type
Description

name

string

ID name, e.g. Vat ID, P.IVA, ABN

value

string

ID value

starterSite

Field
Type
Description

ecwidSubdomain

string

Store subdomain on ecwid.com domain, e.g. mysuperstore in mysuperstore.ecwid.com

customDomain

string

Custom Instant site domain, e.g. www.mysuperstore.com

legalPagesSettings

Field
Type
Description

requireTermsAgreementAtCheckout

boolean

true if customers must agree to store's terms of service at checkout

legalPages

Information about the legal pages set up in a store

legalPages

Field
Type
Description

type

string

Legal page type. One of: "LEGAL_INFO", "SHIPPING_COST_PAYMENT_INFO", "REVOCATION_TERMS", "TERMS", "PRIVACY_STATEMENT"

enabled

boolean

true if legal page is shown at checkout process, false otherwise

title

string

Legal page title

titleTranslated

Available translations for legal page title.

display

string

Legal page display mode – in a popup or on external URL. One of: "INLINE", "EXTERNAL_URL"

displayTranslated

Legal translated page display mode – in a popup or on external URL. One of: "INLINE", "EXTERNAL_URL"

text

string

HTML contents of a legal page

textTranslated

Available translations for legal page text.

externalUrl

string

URL to external location of a legal page

externalUrlTranslated

URL to external location of a translated legal page

designSettings

Field
Type
Description

DESIGN_CONFIG_FIELD_NAME

string or boolean

productFiltersSettings

Field
Type
Description

enabledInStorefront

boolean

true if product filters are enabled in storefront. false otherwise.

filterSections

Specific product filters

filterSections

Field
Type
Description

type

string

Type of specific product filter. Possible values: IN_STOCK, ON_SALE, PRICE, CATEGORIES, SEARCH, SKU, OPTION, ATTRIBUTE, LOCATIONS.

name

string

Name of the product field. Works only with OPTION and ATTRIBUTE filter types and is required for them.

displayComponent

string

Style of displaying OPTION filters on the storefront.

One of:

  • CHECKBOXES - Default checkboxes style.

  • BUTTON_GRID - Grid with buttons that better suits product options like "Size".

enabled

boolean

true if specific product filter is enabled. false otherwise

abandonedSales

Field
Type
Description

autoAbandonedSalesRecovery

boolean

true if abandoned sale recovery emails are sent automatically, false otherwise

salePrice

Field
Type
Description

displayOnProductList

boolean

true if sale price is displayed on product list and product details page. false if sale price is displayed on product details page only

oldPriceLabel

string

Text label for sale price name

oldPriceLabelTranslated

Translations for sale price text labels

displayDiscount

string

Show discount in three modes: "NONE", "ABS" and "PERCENT

socialLinksSettings

Field
Type
Description

facebook

Settings for the Facebook page

instagram

Settings for the Instagram page

twitter

Settings for the Twitter page

youtube

Settings for the Youtube page

vk

Settings for the VK page

pinterest

Settings for the Pinterest page

socialLinksUrl

Field
Type
Description

url

string

URL for the social media page

orderInvoiceSettings

Field
Type
Description

displayOrderInvoices

boolean

If false, Ecwid will disable printing and viewing order invoices for customer and store admin. If true, order invoices will be available to view and print.

attachInvoiceToOrderEmailNotifications

string

Possible values: "ATTACH_TO_ALL_EMAILS", "DO_NOT_ATTACH".

invoiceLogoUrl

string

Invoice logo URL.

translations

Object with text field translations in the "lang": "text" format, where the "lang" is an ISO 639-1 language code. For example:

{
    "en": "Sample text",
    "nl": "Voorbeeldtekst"
}

Translations are available for all active store languages. Only the default language translations are returned if no other translations are provided for the field. Find active store languages with GET /profile request > languages > enabledLanguages.

registrationAnswers

Field
Type
Description

alreadySelling

string

Answer to the question "Do you already have experience selling online?", supported values: getting_started, offline_only, online_different, looking_around

goods

string

Answer to the question "What type of products will you be selling?", supported values: apparel, art, auto, books, electronics, food_restaurant, food_ecommerce, gifts, hardware, health, home, jewelry, office, pet, services, sports, streaming, subscription_product, toys, tobacco, adult, notsure, other

otherGoods

string

Applicable if the field goods has value other. Merchant's text answer to the question "Your goods?"

forSomeone

string

Answer to the question "Are you setting up a store for someone else?", supported values: yes or no

website

string

Answer to the question "Do you already have a website?", supported values: yes or no

platform

string

Applicable if the previous answer is yes. Answer to the question "What website platform do you use?", supported values: joomla, rapid_weaver, wordpress, wix, weebly, blogspot, drupal, custom_site, not_sure, other

customPlatform

string

Applicable if the field platform has value other. Merchant's text answer to the question "Your platform?"

useFor

string

Answer to the question "What are you planning to use Ecwid for?"

shopEase

string

Answer to the question "How would you like your shop to be?"

costAttitude

string

Answer to the question "What are your budget preferences?"

pos

string

Answer to the question "What point-of-sale system are you using?"

salesChannels

string

Answer to the question Where do you sell online?"

ecom

string

Answer to the question "What e-commerce platform do you use to sell?"

tipsSettings

Field
Type
Description

enabled

boolean

true if enabled, false otherwise

type

string

Tip type that defines how its value is calculated. Supported values: ABSOLUTE - tip is added as a flat value PERCENT - tip is added as a percent of the order total

options

Array of numbers

Three number values, e.g. [0, 5, 10]. Each value defines tip amount.

defaultOption

number

Default tip amount. It must match with any value from the options array.

title

string

Text displayed above the tip input field.

subTitle

string

Grayed-out text displayed upder the tip input field.

titleTranslated

Available translations for tip title

subtitleTranslated

Available translations for tip subtitle

Response JSON

A JSON object with the following fields:

Field
Type
Description

updateCount

number

The number of updated items that defines if the request was successful. One of:

1 if the item was updated,

0 if the item was not updated.

Last updated 4 days ago

Was this helpful?

Object

Object

Object

Object

Object

Object

Object

Object

Object

Array

Array

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Details of Ecwid Instant site for account. Learn more about .

connected to a store

Your Facebook Pixel ID. This field is not returned if it is empty in the Ecwid Control Panel.

Object

Object

Object

Object

Snapchat pixel ID from your

Pinterest Tag Id from your

Global site tag from your

Event snippet from your

Object

true if is enabled, false otherwise

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Object

Array

Array

true if the tax rate is included in product prices. More details:

Array

Postcode (or zip code) templates this zone includes. More details: .

Object

Dot coordinates of the polygon (if destination zone is created using ).

Array

Object

Object

Object

Object

Store design settings as seen in . If a specific config field is not provided, it will not be changed

Array

Object

Object

Object

Object

Object

Object

Object

Object

Object

tipsSettings
Instant site
Google Analytics ID
Learn more
Snapchat business account
Pinterest business account
Google Ads account
Google Ads account
LinkUp integration
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
Taxes in Ecwid
Destination zones in Ecwid
Zone on Map
storefront design customization
generalInfo
account
settings
mailNotifications
phoneNotifications
company
formatsAndUnits
languages
shipping
taxSettings
taxes
taxSettings
businessRegistrationID
legalPagesSettings
designSettings
productFiltersSettings
orderInvoiceSettings
socialLinksSettings
registrationAnswers
starterSite
translations
abandonedSales
salePrice
translations
recurringSubscriptionsSettings
customerOrderMessages
adminMessages
customerMarketingMessages
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
MailNotificationsSettings
addressFormat
handlingFee
shippingOrigin
shippingOptions
taxes
rules
geoPolygons
legalPages
translations
translations
translations
translations
filterSections
translations
facebook
instagram
twitter
youtube
vk
pinterest
translations
translations