v1

latestSwagger 2.0Private2026-08-04128286690.5 KB

Technology Partners

PUT (update) Billing Plan Details for a Client Account

Use this PUT method to update the type of billing plan to assign to the Constant Contact client account. The type of billing plan determines which Constant Contact product features that the client account can access. The billing plan that you specify in the request body (plan_type) must already exist in the plan group. Attempting to change to a plan that is currently not available within your partner plan group results in a 400 error response code.

When you create a new client account, the plan_type defaults to TRIAL and the billing_day_of_month defaults to null. The billing_day_of_month property is required if a client account is not set up to use single billing. You can change the day of month (billing_day_of_month) in which to bill a client account only when changing the plan_type value from TRIAL to a different plan_type, otherwise the billing_day_of_month value you enter is ignored. You can choose to enter a specific day of the month or accept the default value, which is the day on which the plan_type value changes from a TRIAL plan to a different plan_type. Changing the plan_type from TRIAL to another plan_type automatically changes the billing_status from Trial to Open.

Only technology partners can access partner endpoints and partner endpoints cannot be tested using the API reference tester. If you are not on the latest billing plan, contact the Constant Contact Partner Team. However, older billing plans and plan_type enum values will continue to be supported.

For more use case information, see PUT Billing Plan Details for a Client Account in the API guide.

put/partner/accounts/{encoded_account_id}/plan

Path parameters

encoded_account_idstring required

Specify the client's unique encoded_account_id.

Request body

plan_typestring

Use this property to update the client account billing plan to a different billing plan. After changing the <code>plan_type</code> from <code>TRIAL</code> to any other billing plan type, you cannot change it back to <code>TRIAL</code>.

<ul> <li><code>TRIAL</code>: A non-billable account with an expiration date that allows clients to try Constant Contact product features.</li> <li><code>GOLD</code>: A billable client account plan.</li> <li><code>SILVER</code>: A billable client account plan.</li> <li><code>BRONZE</code>: A billable client account plan.</li> </ul>

plan_group_idinteger

Updates an existing client account billing plan group to a new billing plan group. If you don't know the plan_group_id to use, contact our API support team.

billing_day_of_monthinteger

This property is required if a client account is not set up to use single billing. You can choose to enter a specific day of the month or accept the default value, which is the day on which the <code>plan_type</code> value changes from a <code>TRIAL</code> plan to a different <code>plan_type</code>. For trial accounts, the value defaults to null. You can only change the <code>billing_day_of_month</code> when changing the <code>plan_type</code> value from <code>TRIAL</code> to a different <code>plan_type</code>, otherwise the value you enter is ignored.

Example request

{
  "plan_type": "GOLD",
  "plan_group_id": 152,
  "billing_day_of_month": 15
}

Response

Request successful.

plan_typestring

The billing plan that is associated with a client's Constant Contact account. The billing plan determines which Constant Contact product features that the client account can access. If you are not on the latest billing plan, contact the Constant Contact Partner Team. However, older billing plans and <code>plan_type</code> enum values will continue to be supported. <ul>

<li><code>TRIAL</code>: Provides limited product features for a non-billed account and the account has an expiration date.</li> <li><code>BRONZE</code>: Billable plan that provides basic email and marketing tools.</li> <li><code>SILVER</code>: Billable plan that provides all features available in the <code>BRONZE</code> plan, and adds some additional email campaign to features, such as contact segmentation and social media ads integration.</li> <li><code>GOLD</code>: Billable plan that provides all available product features.</li> </ul>

billing_statusstring

The client's account billing status. When you first create a client account the <code>billing_status</code> defaults to <code>Trial</code>. Billing status values include:

<ul> <li><code>Trial</code> - A non-paying trial client account (default value).</li> <li><code>Open</code> - An active and paying client account.</li> <li><code>Canceled</code> - A canceled client account.</li> <li><code>Trial End</code> - The trial period has ended for this client account.</li> </ul>

billing_day_of_monthinteger

This property is required when an account is not set up to use single billing. For trial accounts, the value is initially set to <code>null</code>. The value can only be changed when changing the <code>plan_type</code> from a trial account to a different type of plan, otherwise the value you enter is ignored. You can choose to enter a specific day of month or except the default value, which is the day that the <code>plan_type</code> value changes from a trial account plan to a different plan. Valid <code>billing_day_of_month</code> values include <code>1</code> through and including <code>31</code>.

Example response

{
  "plan_type": "GOLD",
  "current_tiers": [
    {
      "usage_type": "CONTACTS",
      "current_usage": 10,
      "tier": 1,
      "tier_max": 500,
      "price": 20,
      "currency_code": "USD"
    }
  ],
  "billing_status": "Open",
  "billing_day_of_month": 15
}