Our v3 API is now available! Learn more by visiting the v3 developer portal. Creating new v2 API keys is no longer supported.

Manage Account Billing

Use this endpoint to view (GET) and update (PUT) a customer's billing information, such as changing an account to a paying account from a trial account. Please note that this endpoint uses basic authentication, and requires the partners username and password be included in each call.

NOTE: This endpoint is available only to approved Constant Contact Technology Platform partners selling Toolkit accounts. Learn more here. It also uses basic authentication as documented on this page.

Methods:

Click a method to view its documentation

GET PUT

DescriptionTOP

Cancel an existing account using the PUT method to change the account status to Cancelled. You must include the cancel_date in ISO-8601 format. You can also specify a cancel_reason for your records.

Here's the list of cancel_reason codes to use, along with their meanings:

Code Description
1 Cost Too High
2 Using A Competitive Service
3 Not Doing Email Marketing
11 Something Missing Or Not Working
12 Doing It In-House
14 Poor Results
21 Too Difficult To Use
27 Cancelled online by customer
30 Dissatisfied With Billing Policies

DescriptionTOP

Use the PUT method to update an account's billing plan. The account is specified using the account_id path parameter. You can modify the following billing plan properties using this endpoint:

  • day of the month on which the account is billed 
  • the type of plan assigned to the account, for example from Trial > Basic > Essential > Ultimate

NOTES:

  • Your partnership needs to be set up for either single- or partner-billing in order to access and manage account billing plans.
  • For trial accounts (plan_type=1), PUT can be used only to modify the plan_type to a value other than 1  (Trial). The API rejects a PUT call where plan_type=1 is in the request payload.
  • You can change the billing_day_of_month only when upgrading the plan_type from 1 (Trial) to a value other than 1; otherwise it is ignored. 

DescriptionTOP

Subscribe to or unsubscribe from a partner webhook topic by making a PUT call to this endpoint with a properly constructed request payload, as shown here. Specify the topic using the topicId path parameter.

PUT: https://api.constantcontact.com/v2/partner/accounts/{accountId}/plan

name

type

default

description

accountId

path

The Constant Contact ID provided at account creation, specifies the account for which to update billing information

api_key

query

REQUIRED; The API key for the application; API key must have Partner level API Access

Example JSON Request BodyTOP

{
    "plan_type": 2,
    "billing_day_of_month": 20
}

Response CodesTOP

code

description

200

Request was successful

400

Bad Request: either JSON was malformed or there was a data validation error

401

Authentication failure; make sure you are using Basic Authentication

404

Either the partner or account specified was not found

405

Unsupported method, only GET and PUT are supported by this endpoint

406

Unsupported accept header value, must be application/json

415

Unsupported content-type in the header, use application/json

500

Internal server error occurred

StructureTOP

property

type(max length)

description

Example ResponseTOP

{
    "status": "Open",
    "plan_type": 2,
    "billing_day_of_month": 20,
    "current_tiers": [
        {
            "price": 45,
            "tier": 1,
            "tier_min": 0,
            "tier_max": 500,
            "current_usage": 0,
            "usage_type": "Contacts"
        }
    ]
}