v1

latestSwagger 2.0Private2026-08-04128286690.5 KB

Technology Partners

POST (create) a Partner Client Account

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. Some client account features will be supported in future releases.

For more use case information, see Create a new Partner Client Account in the API guide.

post/partner/accounts

Request body

contact_emailstring required

A valid email address to associate with the client account.

contact_phonestring

The contact phone number to associate with the client account.

country_codestring required

The two-letter country code (ISO 3166-1 code) that specifies the country in which the client resides.

organization_namestring

The name of organization that identifies the client account.

organization_phonestring

The organization phone number. To set the organization phone number using the user interface, select My Settings and in the Organization Information section, select Edit Organization Information.

state_codestring 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_idstring

The offical time zone to use to represent the physical location associated with the client account.

websitestring

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_namestring required

A unique login name to associate with the client account. The name must only contain alphanumeric characters and '-', '_', '@','.','+'.

passwordstring

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_namestring

The client account owner's first name.

last_namestring

The client account owner's last name.

partner_account_idstring

The unique client account identifier that partners define and use for billing and reporting purposes.

billing_localestring

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_ownerboolean

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_billingboolean

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_outboolean

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_idstring

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_providerstring

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.

Example request

{
  "contact_email": "clients_email@gmail.com",
  "contact_phone": "588-768-6868",
  "country_code": "US",
  "organization_name": "Hanks Fresh Fruit Delivery",
  "organization_phone": "401-244-1000",
  "state_code": "MA",
  "time_zone_id": "US/Eastern",
  "website": "http://your.company.website",
  "login_name": "hank_smith",
  "password": "123456789",
  "first_name": "Hank",
  "last_name": "Smith",
  "partner_account_id": "partner1234",
  "billing_locale": "en_US.",
  "managed_site_owner": true,
  "enable_single_billing": true,
  "gdpr_opt_out": true,
  "external_id": "123456789123456789",
  "external_provider": "Yahoo"
}

Response

Request successful.

encoded_account_idstring

The system generated ID used to uniquely identify a client account.

provision_uuidstring

The system generated ID used to uniquely identify the provisioning of a client account.

Example response

{
  "encoded_account_id": "a08e1izzh8t9",
  "provision_uuid": "x9xx2ede-5a58-4e23-8168-25930c5x7bxb"
}