---
title: "POST /{merchantId}/accounts"
method: POST
path: "/{merchantId}/accounts"
tags: ["accounts"]
---

# POST /{merchantId}/accounts

`POST /{merchantId}/accounts`

Creates a Merchant Center sub-account.

## Path parameters

- `merchantId` string, required

## Request body

- Account — Account data. After the creation of a new account it may take a few minutes before it's fully operational. The methods delete, insert, and update require the admin role.
  - `labelIds` string[] — Manually created label IDs that are assigned to the account by CSS.
  - `sellerId` string — Client-specific, locally-unique, internal ID for the child account.
  - `googleMyBusinessLink` AccountGoogleMyBusinessLink
    - `gmbAccountId` string — The ID of the Business Profile. If this is provided, then `gmbEmail` is ignored. The value of this field should match the `accountId` used by the Business Profile API.
    - `status` string — Status of the link between this Merchant Center account and the Business Profile. Acceptable values are: - "`active`" - "`pending`"
    - `gmbEmail` string — The Business Profile email address of a specific account within a Business Profile. A sample account within a Business Profile could be a business account with set of locations, managed under the Business Profile.
  - `businessInformation` AccountBusinessInformation
    - `address` AccountAddress
      - `country` string — CLDR country code (for example, "US"). All MCA sub-accounts inherit the country of their parent MCA by default, however the country can be updated for individual sub-accounts.
      - `region` string — Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
      - `streetAddress` string — Street-level part of the address. Use `\n` to add a second line.
      - `postalCode` string — Postal code or ZIP (for example, "94043").
      - `locality` string — City, town or commune. May also include dependent localities or sublocalities (for example, neighborhoods or suburbs).
    - `koreanBusinessRegistrationNumber` string — The 10-digit [Korean business registration number](https://support.google.com/merchants/answer/9037766) separated with dashes in the format: XXX-XX-XXXXX. This field will only be updated if explicitly set.
    - `phoneVerificationStatus` string — Verification status of the phone number of the business. This status is read only and can be updated only by successful phone verification. Acceptable values are: - "`verified`" - "`unverified`"
    - `phoneNumber` string — The phone number of the business in [E.164](https://en.wikipedia.org/wiki/E.164) format. This can only be updated if a verified phone number is not already set. To replace a verified phone number use the `Accounts.requestphoneverification` and `Accounts.verifyphonenumber`.
    - `customerService` AccountCustomerService
      - `phoneNumber` string — Customer service phone number.
      - `url` string — Customer service URL.
      - `email` string — Customer service email.
  - `id` string, uint64 — Required. 64-bit Merchant Center account ID.
  - `businessIdentity` AccountBusinessIdentity — The [business identity attributes](https://support.google.com/merchants/answer/10342414) can be used to self-declare attributes that let customers know more about your business.
    - `smallBusiness` AccountIdentityType — The account identity type used to specify attributes.
      - `selfIdentified` boolean — Optional. Indicates that the business identifies itself with a given identity type. Setting this field does not automatically mean eligibility for promotions.
    - `womenOwned` AccountIdentityType — The account identity type used to specify attributes.
      - `selfIdentified` boolean — Optional. Indicates that the business identifies itself with a given identity type. Setting this field does not automatically mean eligibility for promotions.
    - `latinoOwned` AccountIdentityType — The account identity type used to specify attributes.
      - `selfIdentified` boolean — Optional. Indicates that the business identifies itself with a given identity type. Setting this field does not automatically mean eligibility for promotions.
    - `includeForPromotions` boolean — Required. By setting this field, your business may be included in promotions for all the selected attributes. If you clear this option, it won't affect your identification with any of the attributes. For this field to be set, the merchant must self identify with at least one of the `AccountIdentityType`. If none are included, the request will be considered invalid.
    - `blackOwned` AccountIdentityType — The account identity type used to specify attributes.
      - `selfIdentified` boolean — Optional. Indicates that the business identifies itself with a given identity type. Setting this field does not automatically mean eligibility for promotions.
    - `veteranOwned` AccountIdentityType — The account identity type used to specify attributes.
      - `selfIdentified` boolean — Optional. Indicates that the business identifies itself with a given identity type. Setting this field does not automatically mean eligibility for promotions.
  - `conversionSettings` AccountConversionSettings — Settings for conversion tracking.
    - `freeListingsAutoTaggingEnabled` boolean — When enabled, free listing URLs have a parameter to enable conversion tracking for products owned by the current merchant account. See [auto-tagging](https://support.google.com/merchants/answer/11127659).
  - `kind` string — Identifies what kind of resource this is. Value: the fixed string "`content#account`".
  - `websiteUrl` string — The merchant's website.
  - `automaticLabelIds` string[] — Automatically created label IDs that are assigned to the account by CSS Center.
  - `cssId` string, uint64 — ID of CSS the account belongs to.
  - `youtubeChannelLinks` AccountYouTubeChannelLink[] — Linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
    - `status` string — Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it's pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it's still pending or with status `pending` when it's already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
    - `channelId` string — Channel ID.
  - `automaticImprovements` AccountAutomaticImprovements — The automatic improvements of the account can be used to automatically update items, improve images and shipping.
    - `shippingImprovements` AccountShippingImprovements — Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data
      - `allowShippingImprovements` boolean — Enables automatic shipping improvements.
    - `itemUpdates` AccountItemUpdates — Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown.
      - `effectiveAllowAvailabilityUpdates` boolean — Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
      - `effectiveAllowStrictAvailabilityUpdates` boolean — Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
      - `accountItemUpdatesSettings` AccountItemUpdatesSettings — Settings for the Automatic Item Updates.
        - `allowStrictAvailabilityUpdates` boolean — If allow_availability_updates is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also allow availability updates.
        - `allowPriceUpdates` boolean — If price updates are enabled, Google always updates the active price with the crawled information.
        - `allowAvailabilityUpdates` boolean — If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer’s page.
        - `allowConditionUpdates` boolean — If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.
      - `effectiveAllowPriceUpdates` boolean — Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
      - `effectiveAllowConditionUpdates` boolean — Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
    - `imageImprovements` AccountImageImprovements — This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973)
      - `effectiveAllowAutomaticImageImprovements` boolean — Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
      - `accountImageImprovementsSettings` AccountImageImprovementsSettings — Settings for the Automatic Image Improvements.
        - `allowAutomaticImageImprovements` boolean — Enables automatic image improvements.
  - `accountManagement` string — Output only. How the account is managed. Acceptable values are: - "`manual`" - "`automatic`"
  - `users` AccountUser[] — Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
    - `admin` boolean — Whether user is an admin.
    - `orderManager` boolean — This role is deprecated and can no longer be assigned. Any value set will be ignored.
    - `emailAddress` string — User's email address.
    - `reportingManager` boolean — Whether user is a reporting manager. This role is equivalent to the Performance and insights role in Merchant Center.
    - `paymentsAnalyst` boolean — This role is deprecated and can no longer be assigned. Any value set will be ignored.
    - `paymentsManager` boolean — This role is deprecated and can no longer be assigned. Any value set will be ignored.
    - `readOnly` boolean — Optional. Whether user has standard read-only access.
  - `adsLinks` AccountAdsLink[] — Linked Ads accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the Ads interface or through the Google Ads API. To delete an active link, or to cancel a link request, remove it from the list.
    - `adsId` string, uint64 — Customer ID of the Ads account.
    - `status` string — Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google Ads or `pending` if it's pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it's still pending or with status `pending` when it's already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - "`active`" - "`pending`"
  - `name` string — Required. Display name for the account.
  - `adultContent` boolean — Indicates whether the merchant sells adult content.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/content.md) · [All operations](https://skmtc.net/google/apis/content/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/content/versions/1033388fc86f/schema)