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.
Click a method to view its documentation
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 |
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:
NOTES:
plan_type=1
is in the request payload.billing_day_of_month
only when upgrading the plan_type from 1 (Trial) to a value other than 1; otherwise it is ignored. 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 |
{ "plan_type": 2, "billing_day_of_month": 20 }
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 |
property |
type(max length) |
description |
---|
{ "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" } ] }