---
title: "Add store"
method: POST
path: "/3.0/ecommerce/stores"
tags: ["ecommerce"]
---

# Add store

`POST /3.0/ecommerce/stores`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/ecommerce/stores`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/ecommerce/stores/post.ts> (a function with typed inputs; its response is checked against the schema)

Add a new store to your Mailchimp account.

## Request body

- object: An individual store in an account.
  - `address` object: The store address.
    - `address1` string: The store's mailing address.
    - `address2` string: An additional field for the store's mailing address.
    - `city` string: The city the store is located in.
    - `country` string: The store's country.
    - `country_code` string: The two-letter code for to the store's country.
    - `latitude` union: The latitude of the store location.
      - number
      - string
    - `longitude` union: The longitude of the store location.
      - number
      - string
    - `postal_code` string: The store's postal or zip code.
    - `province` string: The store's state name or normalized province.
    - `province_code` string: The two-letter code for the store's province or state.
  - `currency_code` string, required: The three-letter ISO 4217 code for the currency that the store accepts.
  - `domain` string: The store domain. This parameter is required for Connected Sites and Google Ads.
  - `email_address` string: The email address for the store.
  - `id` string, required: The unique identifier for the store.
  - `is_syncing` boolean: Whether to disable automations because the store is currently [syncing](https://mailchimp.com/developer/marketing/docs/e-commerce/#pausing-store-automations).
  - `list_id` string, required: The unique identifier for the list associated with the store. The `list_id` for a specific store cannot change.
  - `money_format` string: The currency format for the store. For example: `$`, `£`, etc.
  - `name` string, required: The name of the store.
  - `phone` string: The store phone number.
  - `platform` string: The e-commerce platform of the store.
  - `primary_locale` string: The primary locale for the store. For example: `en`, `de`, etc.
  - `timezone` string: The timezone for the store.

## Response `200`

- object: An individual store in an account.
  - `_links` object[]: A list of link types and descriptions for the API schema documents.
    - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
    - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
    - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
    - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
  - `address` object: The store address.
    - `address1` string: The store's mailing address.
    - `address2` string: An additional field for the store's mailing address.
    - `city` string: The city the store is located in.
    - `country` string: The store's country.
    - `country_code` string: The two-letter code for to the store's country.
    - `latitude` number: The latitude of the store location.
    - `longitude` number: The longitude of the store location.
    - `postal_code` string: The store's postal or zip code.
    - `province` string: The store's state name or normalized province.
    - `province_code` string: The two-letter code for the store's province or state.
  - `automations` object: Details for the automations attached to this store.
    - `abandoned_browse` object: abandonedBrowse automation details. abandonedBrowse is also known as Product Retargeting Email or Retarget Site Visitors on the web.
      - `id` string: Unique ID of automation parent campaign.
      - `is_supported` boolean: Whether this store supports the abandonedBrowse automation.
      - `status` 'save' | 'sending' | 'paused': Status of the abandonedBrowse automation.
    - `abandoned_cart` object: abandonedCart automation details.
      - `id` string: Unique ID of automation parent campaign.
      - `is_supported` boolean: Whether this store supports the abandonedCart automation.
      - `status` 'save' | 'sending' | 'paused': Status of the abandonedCart automation.
  - `connected_site` object: The Connected Site associated with the store.
    - `site_foreign_id` string: The unique identifier for the connected site.
    - `site_script` object: The script used to connect your site with Mailchimp.
      - `fragment` string: A pre-built script that you can copy-and-paste into your site to integrate it with Mailchimp.
      - `url` string: The URL used for any integrations that offer built-in support for connected sites.
  - `created_at` string, date-time: The date and time the store was created in ISO 8601 format.
  - `currency_code` string: The three-letter ISO 4217 code for the currency that the store accepts.
  - `domain` string: The store domain. The store domain must be unique within a user account.
  - `email_address` string: The email address for the store.
  - `id` string: The unique identifier for the store.
  - `is_syncing` boolean: Whether to disable automations because the store is currently [syncing](https://mailchimp.com/developer/marketing/docs/e-commerce/#pausing-store-automations).
  - `list_id` string: The unique identifier for the list that's associated with the store. The `list_id` for a specific store can't change.
  - `list_is_active` boolean: The status of the list connected to the store, namely if it's deleted or disabled.
  - `money_format` string: The currency format for the store. For example: `$`, `£`, etc.
  - `name` string: The name of the store.
  - `phone` string: The store phone number.
  - `platform` string: The e-commerce platform of the store.
  - `primary_locale` string: The primary locale for the store. For example: `en`, `de`, etc.
  - `timezone` string: The timezone for the store.
  - `updated_at` string, date-time: The date and time the store was last updated in ISO 8601 format.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)