webservices

Account Email Addresses Resource

by Administrator on ‎03-25-2011 10:04 AM

The account settings email address collection and resource allows you to retrieve a list of registered email addresses on your account as specified in the Settings in the UI. These email addresses are used in conjunction with campaign resource to specify From Email and Reply To email addresses.

 

To learn more about how to use email address collection and resource, refer to Retrieving Account Email Addresses.

 

Request Format

 

GET https://api.constantcontact.com/ws/customers/{user-name}/settings/emailaddresses/{email-id}

To learn more about how to retrieve a list of email addresses registered in your account, please refer to Retrieving Account Email Addresses.

 

Response Format

 

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns="http://www.w3.org/2005/Atom">
<link href="/ws/customers/joesflowers/settings/emailaddresses/1" rel="edit" />
<id>http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses/1</id>
<title type="text">joesflowers@example.com</title>
<updated>2009-05-21T17:44:04.609Z</updated>
<author>
<name>Constant Contact</name>
</author>
<content type="application/vnd.ctct+xml">
<Email xmlns="http://ws.constantcontact.com/ns/1.0/" id="http://api.constantcontact.
com/ws/customers/joesflowers/settings/emailaddresses/1">
<EmailAddress>joesflowers@example.com</EmailAddress>
<Status>Verified</Status>
<VerifiedTime>2009-05-21T17:44:04.609Z</VerifiedTime>
</Email>
</content>
<source>
<id>http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses</id>
<title type="text" />
<link href="http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses" />
<link href="http://api.constantcontact.com/ws/customers/joesflowers/settings/emailaddresses" rel="self" />
<author>
<name>joesflowers</name>
</author>
<updated>2009-10-01T21:06:25.486Z</updated>
</source>
</entry>

 

URI Format


URI Component Description
user-name

The account owner's Constant Contact user name.
Value must be in lower case.

settings Represents the settings of your account.
emailaddresses Represents email addresses registered under the account.
email-id

Retrieves an individual email address entry. 

Obtained the specific contact's URI with its ID from the Location header after creating a new <entry> or from an existing <entry> in the <link> element that has in the rel="edit" attribute. 

 

Email Address Elements Data


Name Allowed values Editable? Description
EmailAddress   No A valid email address
Status Verified
Pending
No The verification status of the email address.
VerifiedTime   No The time the email address was verified. Not returned if the address is in a Pending state