Accounts: insert

Creates a Merchant Center sub-account. Try it now.


HTTP request



Parameter name Value Description
Path parameters
merchantId unsigned long The ID of the managing account. This must be a multi-client account.
Optional query parameters
dryRun boolean Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).


This request requires authorization with the following scope:


For more information, see the authentication and authorization page.

Request body

In the request body, supply an Accounts resource with the following properties:

Property name Value Description Notes
Required Properties
name string Display name for the account. writable
Optional Properties
adultContent boolean Indicates whether the merchant sells adult content. writable
adwordsLinks[].adwordsId unsigned long Customer ID of the AdWords account. writable
businessInformation nested object The business information of the account. writable
businessInformation.address nested object The address of the business. writable
businessInformation.address.locality string City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). writable
businessInformation.address.postalCode string Postal code or ZIP (e.g. "94043"). writable
businessInformation.address.region string Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). writable
businessInformation.address.streetAddress string Street-level part of the address. writable
businessInformation.customerService nested object The customer service information of the business. writable string Customer service email. writable
businessInformation.customerService.phoneNumber string Customer service phone number. writable
businessInformation.customerService.url string Customer service URL. writable
businessInformation.phoneNumber string The phone number of the business. writable
googleMyBusinessLink.gmbEmail string The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account. writable
sellerId string Client-specific, locally-unique, internal ID for the child account. writable
users[] list Users with access to the account. Every account (except for subaccounts) must have at least one admin user. writable
users[].admin boolean Whether user is an admin. writable
users[].emailAddress string User's email address. writable
users[].orderManager boolean Whether user is an order manager. writable
users[].paymentsAnalyst boolean Whether user can access payment statements. writable
users[].paymentsManager boolean Whether user can manage payment settings. writable
websiteUrl string The merchant's website. writable


If successful, this method returns an Accounts resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.