Constant Contact .NET SDK

Installation

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

1. Download and build the 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.

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

Usage

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.1) For windows forms

_accessToken = OAuth.AuthenticateFromWinProgram(ref state);

2.2) For web forms

(This is just an example, the login actions is done at a button click)

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(_apiKey, _accessToken);
ContactService contactService = new ContactService(userServiceContext);

3.2) Create a service object using the ConstantContactFactory

IUserServiceContext userServiceContext = new UserServiceContext(_apiKey, _accessToken);
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);