Constant Contact IOS SDK

Installation

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

1. Open the project in Xcode

2. Drag The Constant Contact Folder into the Project Navigation Panel.

3. Be sure to make the following selections in the popup:
   Folders : "Create groups for ant added folders"
   Add to targets: ""
   Destination: "Copy items into destination group's folder(if needed)"

Usage

1. Include the following code in the file you wish to use the SDK:

#import "CTCTOAuth2.h" -for the authentication process


#import "Config.h" -for api key and other configuration elements


#import "ContactsCollection.h" -for contact collection manipulation


#import "ListsCollection.h" -for list collection manipulation


#import "ActivityService.h" -for activity manipulation


#import "EmailCampaignService.h" -for email campaign manipulation


#import "CampaignScheduleService.h" -for campaign schedule manipulation


#import "CampaignTrackingService.h" -for campaign tracking manipulation


#import "ContactTrackingService.h" -for contact tracking manipulation


#import "VerifiedEmailAddress.h" -to obtain the valid email addresses used in some calls

2. Create an authentication object using your user credentials:

Instantiate your credentials

In the Config directory open the Congif.plist file.

Select the config drop down section and fill in your consumer_secret, api_key, and redirect_uri keys.

######Store the values in a "CTCTOAuth2" object

CTCTOAuth2 *ctctOauth2 = [[CTCTOAuth2 alloc] initWithClientID:[Config valueForType:@"config" key:@"api_key"]
									    redirectURI:[Config valueForType:@"config" key:@"redirect_uri"]
									    userName:YourUserName 
									    password:YourPassword];

Note: 'your redirect url' is the URL of the action you just created.

3. Make the call for the user token using the initiated "CTCTOAuth2" object, and save the token in a object of your choosing.

NSString *myToken = [ctctOauth2 accessToken];

Note: Requesting the access token implicitly means that you are giving the all the permissions needed by the SDK, no further permissions are required.

4. Start using the SDK.

######Example for getting a array of contacts

HttpResponse *result = [ContactsCollection contactsWithAccessToken: myToken];
NSArray *contactArray = result.data;