Skip to content
This repository has been archived by the owner on Dec 16, 2021. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Constant Contact .NET SDK


In order to use the Constant Contact SDK you have to follow these steps:

  1. Download and build the CTCTWrapper project so that CTCT.dll is generated. Add the CTCT.dll library to your references project.

  2. Place your credentials in the app.config or web.config file under the appSettings tag.

    <add key="APIKey" value="APIkey"/>
    <add key="RedirectURL" value="RedirectURL"/>


SDK Documentation is hosted at

API Documentation is located at


1) Include namespaces

In the file you wish to use the SDK include the following code in your file:

using CTCT;
using CTCT.Components;
using CTCT.Components.Contacts;
using CTCT.Components.EmailCampaigns;
using CTCT.Exceptions;

2) Get the access token

2.0) If the access token was already obtained, you may set the API Key and token like this. NOT ideal if you want to access multiple/variable Constant Contact accounts.

private string _apiKey = "xxxxxxxxx"; 
private string _accessToken = "xxxx-xxxxx-xxxxx-xxxx"; 

2.1) For windows forms

_accessToken = OAuth.AuthenticateFromWinProgram(ref state);

2.2) For web forms

(This will require the user to grant access in a browser window.)

protected void Page_Load(object sender, EventArgs e)
    var code = HttpContext.Current.Request.QueryString["code"];
    if (!string.IsNullOrWhiteSpace(code))
        _accessToken = OAuth.GetAccessTokenByCodeForWebApplication(HttpContext.Current, code);
protected void ButtonLogin_Click(object sender, EventArgs e)
   OAuth.AuthorizeFromWebApplication(HttpContext.Current, "ok");

3) Create a service object, for example create a ContactService object

3.1) Create a service object directly

IUserServiceContext userServiceContext = new UserServiceContext(_accessToken, _apiKey);
ContactService contactService = new ContactService(userServiceContext);

3.2) Create a service object using the ConstantContactFactory

IUserServiceContext userServiceContext = new UserServiceContext(_accessToken, _apiKey);
ConstantContactFactory serviceFactory = new ConstantContactFactory(userServiceContext);
ContactService contactService = serviceFactory.CreateContactService();

4) Use the SDK via the created object

Example of getting a contact:

int contactId = 12345;
Contact contact = contactService.GetContact(contactId);