---
title: "POST (create) a Partner Client Account"
method: POST
path: "/partner/accounts"
tags: ["Technology Partners"]
---

# POST (create) a Partner Client Account

`POST /partner/accounts`

Use this POST method to create a new Constant Contact client account under your partner account, set up the billing plan for the account, and to add the new client to the default contact list.

Newly created accounts are free trials which give the user up to 60 days to try Constant Contact before buying. Trial accounts have limits depending on the services that are included.

If a field validation error occurs, a 400 response message is returned.

If provisioning does not complete successfully due to unavailable dependencies, such as database or dependent services, a 503 response message is returned. By default, the client account provision data is stored and processed when provisioning becomes available.

If the partner client account has the Single Sign On (SSO) for all users feature enabled, all users in the client account can sign into the account using SSO. This feature must be set up through the Constant Contact Partner team. For feature details, see [Configuring Identity Provider Initiated SSO](/api_guide/partner_sso_config.html). Some client account features will be supported in future releases. 

For more use case information, see [Create a new Partner Client Account](/api_guide/partners_accts_create.html) in the API guide.

## Request body

- Provision
  - `contact_email` string, required — A valid email address to associate with the client account.
  - `contact_phone` string — The contact phone number to associate with the client account.
  - `country_code` string, required — The two-letter country code (ISO 3166-1 code) that specifies the country in which the client resides.
  - `organization_name` string — The name of organization that identifies the client account.
  - `organization_phone` string — The organization phone number. To set the organization phone number using the user interface, select <b>My Settings</b> and in the <b>Organization Information</b> section, select <b>Edit Organization Information</b>.
  - `state_code` string, required — The two-letter state code that represents the US state (<code>country_code</code> is <code>US</code> ) or Canadian province (<code>country_code</code> is <code>CA</code>) where the client's organization is physically located. Leave the <code>state_code</code> blank for non-US states and Canadian provinces.
  - `time_zone_id` string — The offical time zone to use to represent the physical location associated with the client account.
  - `website` string — The client's website URL. Specifying the website URL eliminates the need for clients to provide that information. Requires a valid URL starting with http:// or https://.
  - `login_name` string, required — A unique login name to associate with the client account. The name must only contain alphanumeric characters and '-', '_', '@','.','+'.
  - `password` string — Required if not using Single Sign On (SSO) or external authenticator. The password to associate with the client account. Passwords must be at least 8 characters and no more than 80 characters in length. Passwords can contain alphabetical letters (A-Z) and (a-z), numbers (0-9), special characters (! @ # $ etc.) and spaces. Passwords should not contain any part of your username and cannot be the same as your last password, or be listed on an industry database; we check for easily guessed or compromised passwords. Your new password is not returned in the response payload for security reasons. If using SSO authentication, use <code>idp_provider</code> and <code>idp_provider_id</code> instead of <code>password</code>.
  - `first_name` string — The client account owner's first name.
  - `last_name` string — The client account owner's last name.
  - `partner_account_id` string — The unique client account identifier that partners define and use for billing and reporting purposes.
  - `billing_locale` string — The currency to use when billing the client account. Valid values are: <code>en_US</code> (default, US Dollars) or <code>en_GB</code> (British Pounds).
  - `managed_site_owner` boolean — By default, if the client account is setup as a managed account <code>managed_site_owner</code> is automatically set to <code>true</code> and attempting to override the setting with <code>false</code> is ignored. This helps to avoid getting an account into an unknown state.
  - `enable_single_billing` boolean — If a partner account is setup to allow for single billing and the <code>managed_site_owner</code> property is set to <code>true</code>, use this property to enable the single billing feature for the client account. See your account manager for more information.
  - `gdpr_opt_out` boolean — When creating accounts for users who have opted-out of any marketing communications, set the <code> gdpr_opt_out</code> to <code>true</code> so that Constant Contact does not send any marketing communications to the account.
  - `external_id` string — The ID used to uniquely identify the client account for the external authenticator. Do not use the <code>password</code> property when using an external authenticator.
  - `external_provider` string — The name of the provider who externally authenticates this customer. For example, PayPal or Yahoo. Do not use the <code>password</code> property when using an external authenticator.

## Response `201`

Request successful.

- ProvisionResponse
  - `encoded_account_id` string — The system generated ID used to uniquely identify a client account.
  - `provision_uuid` string — The system generated ID used to uniquely identify the provisioning of a client account.

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — The requested resource was not found.
- `409` — Conflict. The resource you are creating or updating conflicts with an existing resource.
- `415` — Unsupported Media Type.
- `500` — There was a problem with our internal service.
- `503` — Our internal service is temporarily unavailable.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/versions/4b4a534c818d/schema)