Create store

POST https://app.ecwid.com/api/v3/stores

Required access scopes

This API call requires the following access scope: create_stores

Headers

All request headers are required.

Header	Type	Description
X-Ecwid-App-Client-Id	string	Your application’s client_id
X-Ecwid-App-Secret-Key	string	Your application’s client_secret

Query params

All query params are optional

Name	Type	Description
returnApiToken	boolean	trueto include token into API response. When a store is successfully created, API will return Store ID ('id') of the created store and API token that should be saved and used later for API calls for this store.

Request JSON

Field	Type	Description
merchant	object merchant	Store owner’s account data. Required
affiliatePartner	object affiliatePartner	Affiliate partner data.
profile	object profile	General settings for the new store.

merchant

Field	Type	Description
email	string	Store owner’s email. Required
name	string	Store owner’s name. Required
password	string	Ecwid account password. Minimum password length is 6 characters.
ip	string	Store owner’s IP. Is used to predetermine user’s location and set default settings in store
facebookLogin	object facebookLogin	Merchant's Facebook login info – when creating account via social buttons. Use Facebook or Google info for registration with social account. Facebook email and name will be used for this Ecwid account if available in Facebook
googleLogin	object googleLogin	Merchant's Google login info – when creating account via social buttons. Use Facebook or Google info for registration with social account. Google email and name will be used for this Ecwid account if available on Google

facebookLogin

Field	Type	Description
facebookID	string	Store owner’s Facebook ID
facebookToken	string	Store owner’s Facebook token

googleLogin

Field	Type	Description
googleToken	string	Store owner’s Google token

affiliatePartner

Field	Type	Description
source	string	Determines the source of the registered account
ambassador	object ambassador	Ambassador affiliate account details. More info

ambassador

Field	Type	Description
ref	string	Referral account ID
campaignId	string	Campaign ID

profile

See Update store profile API call for reference.

Response JSON

Field	Type	Description
id	number	ID of the created store
token	string	A secret token for the created store.