Hello Neil,   The access token you receive during OAuth is the Bearer token you use for making calls to the API. This access token is what tells us which Constant Contact account you are making calls to, as well as the scopes that your app has access to. You would use the Basic authentication of your API Key and Secret during the initial OAuth call, and any refresh call.   Once you have gone through the OAuth process initially, you will receive a refresh token along with your access token. The refresh token can be used to obtain a new access token (see: https://v3.developer.constantcontact.com/api_guide/server_flow.html#step-5-refresh-the-access-token) as the access token will expire after 1 hour of non-use up to a maximum of 24 hours. Depending on how often you will be making calls, you may consider building the refresh flow linked above into your application to get the new access token and refresh token before making your calls. Please have a look and let me know if you have any other questions!   Regards, David B. Tier II API Support Engineer ... View more

Hello,   Thank you for reaching out to Constant Contact API Developer Support.   Unfortunately our API does not offer webhooks. We do offer an updated subscriber email to be sent to an account owner on a daily or weekly basis. This email includes newly added contacts as well as those who have unsubscribed. For details on this email, see: https://knowledgebase.constantcontact.com/articles/KnowledgeBase/5530-automatic-email-updates-for-sign-ups-and-unsubscribes   I will make sure this feedback gets to our product management team for consideration.   Sincerely, David B. Tier II API Support Engineer ... View more

Hello,   When making calls with our V3 API, you need to include an Authorization header that includes an access token obtained through the OAuth flow. The access token is what identifies which Constant Contact account you are making calls for, and whether your application has been granted the necessary permission for the type of call you are making. Your API Key and Secret are only used in the OAuth flow, and when making subsequent calls, your API Key is identified from the access token used in your regular API calls.   The URL you would call would be: https://api.cc.email/v3/contacts?email={email_address} The headers you would use would be: Content-Type: application/json Authorization: Bearer {access_token} Please let me know if you have any other questions!   Regards, David B. Tier II API Support Engineer     ... View more

Hello,   I was able to add this character to a name field in the Constant Contact website UI, though it does not seem to be supported properly with our V3 API. I have brought this to our development team to review a possible enhancement. Please let me know if you have any other questions!   Regards, David B. Tier II API Support Engineer ... View more

Hello, Thank you for reaching out to Constant Contact API Developer Support.   There are a variety of factors involved in the sending of an automated email. Please email webservices@constantcontact.com with your Constant Contact username, and details such as: email address being added date and timeframe you added the contacts list they were added to which automated email campaign you expect to be sent to them With that information we can dig into the details on why your contacts specifically may not have been sent the automated email.   Regards, David B. Tier II API Support Engineer   ... View more

Hello,   The issue in the original post was due to a temporary system issue. I'm not aware of a repeat of that issue. Are you still having this problem? During the previous issue we were able to replicate using our API Tester page at https://v3.developer.constantcontact.com/api_reference/index.html#!/Contacts/getContacts   If you are still having the issue, do you also see it using this API Reference tester?   Please have a look and let me know if you have any questions!   Regards, David B. Tier II API Support Engineer ... View more

Hello, Thank you for reaching out to Constant Contact API Developer Support. At this time you can create an email campaign, but not yet schedule one with our V3 API. We're still in the process of building out additional features for V3. Our V2 API has the scheduling and reporting endpoints implemented and available for use; you are welcome to still develop with our V2 API. For documentation on this in V2 see the following links. Using the Email Campaign Endpoints: https://developer.constantcontact.com/docs/email-campaigns/email-campaign-api-index.html Email Campaign Schedule Collection: https://developer.constantcontact.com/docs/campaign-scheduling/campaign-schedule-collection.html?method=POST Tracking Email Campaign Results: https://developer.constantcontact.com/docs/campaign-tracking/email-campaign-tracking-.html Regards, David B. Tier II API Support Engineer ... View more

Hello, Thank you for reaching out to Constant Contact API Developer Support. Are you seeing inconsistent results for the same account, or is your integration used with multiple accounts and only some accounts return null when this call is made? Regards, David B. Tier II API Support Engineer ... View more

Hello,   Thank you for reaching out to Constant Contact API Developer Support.   We are still in the process of building out the feature set of our V3 API. As of right now there aren't any account summary endpoints that would provide you with this information, however we are hoping to have these included in our release at the end of May or beginning of June. Obviously I can't guarantee that, but that is currently what we are shooting for. Regards, David B. Tier II API Support Engineer ... View more

Hello, While there are no current plans to retire the Tags feature, our Contacts team doesn't have immediate plans for any new development involving it at this time in favor of our Segmentation feature. Our v3 API does have advanced Custom Fields features, which work well with Segments allowing you to easily segment out your list and replicate the behavior of Tags. See here for details on our Segments feature:  http://knowledgebase.constantcontact.com/articles/KnowledgeBase/25205-Define-Your-Own-List-Segments Regards, David B. Tier II API Support Engineer ... View more

Hello,   I'd like to look into this specific contact. Please email us at webservices@constantcontact.com and include the following: A code sample of how you are building this contact object The username of the Constant Contact account you are working with This way I can troubleshoot in more detail. Regards, David B. Tier II API Support Engineer ... View more

Hello,   Thank you for reaching out to Constant Contact API Developer Support.   Would you be able to verify that once you have added the address to the $contact object that it is added correctly?   Also, I'm wondering if manually setting the address might have a different outcome. E.g.: $contact->addresses[] = $address;   Regards, David B. Tier II API Support Engineer ... View more

Hello,   I know of a 3rd party plugin for Gravity Forms that can connect to constant contact. See https://wordpress.org/plugins/gravity-forms-constant-contact/ Please note that both of these are 3rd party products and not built or supported by Constant Contact directly, so I'm limited in the support I can provide with using them.   You can also create a landing page signup form within Constant Contact that will let subscribers check off which list(s) they want to sign up for. See this link for details:  https://knowledgebase.constantcontact.com/articles/KnowledgeBase/5298-edit-web-sign-up-forms   Regards, David B. Tier II API Support Engineer ... View more

Hello,   Thank you for your continued concern.   I'm asking our development team to review this further. Regards, David B. Tier II API Support Engineer ... View more

Hello,   Thank you for reaching out to Constant Contact API Developer Support.   Most of the Latin-based languages use the standard 8-bit Character Encoding that Constant Contact and virtually all email clients support. Text written in these languages can be used without any hassle or compatibility issues. Examples of 8-bit languages include English, Danish, Dutch, French, German, Italian, Norwegian, Portuguese, Spanish, and Swedish. These are also the languages that Constant Contact supports for the Email Footer/Privacy Policy.   Other languages, such as Japanese, Mandarin, Chinese, Korean, and Vietnamese use a 16-bit Character Encoding (sometimes referred to as "Double-Byte" or "Unicode" characters). Constant Contact does not officially support these languages. At this time there are no plans to change the way our API currently interacts with them in this way.   I have passed your feedback on to our product team for consideration. Please let me know if you have any other questions!   Regards,   David B. Tier II API Support Engineer ... View more

Hello,   The Access Token comes from the OAuth process and is what tells us which Constant Contact account to access, and that your app has permission to do so.   See this page in our documentation: https://v3.developer.constantcontact.com/api_guide/auth_overview.html   Regards, David B. Tier II API Support Engineer ... View more

Hello,   Thank you for reaching out to Constant Contact API Developer Support.   You will want to set your Authorization header to be "Bearer " plus whatever your access token is. So using your example:   'Authorization' => 'Bearer 0000000-0000-0000-bdde-e7d90fcf0cc7', Please let me know if you have any other questions!   Regards, David B. Tier II API Support Engineer ... View more

Hello,   Refresh Tokens do not expire the way that Access Tokens do.   When using the Server flow, you are given a Refresh Token as well as an Access Token. When your Access Token has expired, you can exchange the Refresh Token for a new Access Token as well as a new Refresh Token. You would then continue doing this with the new Refresh Tokens obtained. Regards, David B. Tier II API Support Engineer     ... View more

Hello,   Thank you for reaching out to Constant Contact API Developer Support.   At this time you can only create an automated autoresponder email series within your Constant Contact account through the website UI. However, once this campaign is created, it would be sent to any contacts added to the list associated with it. This would work for any contacts added to that list, whether you add them manually in the UI, or use the API to add them.   Our main support team is available to assist with any questions you have about setting up or using automated email campaigns. For details on how to create and schedule an autoresponder campaign, see the following article from our knowledgebase: https://knowledgebase.constantcontact.com/articles/KnowledgeBase/5520-automated-emails?lang=en_US#Autoresponder   Please have a look and let me know if you have any other questions!   Regards, David B. Tier II API Support Engineer ... View more

Hello,   Our V2 and V3 APIs do not share api keys or access tokens. You cannot use a V2 key and access token to make calls on our V3 API. I recommend starting in our Quick Start guide for V3 to get a feel for it: https://v3.developer.constantcontact.com/api_guide/getting_started.html   You can also use this page in our documentation on how to use OAuth in your application: https://v3.developer.constantcontact.com/api_guide/auth_overview.html   Our V3 API is full featured for contacts endpoints, and we have additional endpoints and features in development. Regards,   David B. Tier II API Support Engineer ... View more

Hi,   If you're having trouble using HttpRequest() you can use cURL instead. Here's an example:   // Define your access token $access_token = "{YOUR_ACCESS_TOKEN}"; // Initialize a cURL object $ch = curl_init(); // Define base URL $base = 'https://api.cc.email/v3/'; // Create full request URL with chosen parameters $url = $base . '/contacts?status=all&limit=500&include_count=true'; // Set the URL curl_setopt($ch, CURLOPT_URL, $url); // Set authorization header $authorization = 'Authorization: Bearer ' . $access_token; curl_setopt($ch, CURLOPT_HTTPHEADER, array($authorization)); // Set cURL to expect response curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // Make the call $result = curl_exec($ch); // Close cURL curl_close($ch);   See our V3 documentation for the types of parameters you can put onto the request URL here: https://v3.developer.constantcontact.com/api_reference/index.html#!/Contacts/getContacts Sincerely, David B. Tier II API Support Engineer ... View more

Hello In our V3 API, the API Key is not required to be included with your calls since we derive the API Key from the Access Token itself. The access token goes into the Authorization header the same way that it would in V2. From the code example linked above (just replace "{access_token}" with your access token): $request->setHeaders(array( 'cache-control' => 'no-cache', 'authorization' => 'Bearer {access_token}', 'content-type' => 'application/json', 'accept' => 'application/json' )); HttpRequest is often included with PHP, though you may need to enable it (https://stackoverflow.com/a/4565482). You are free to use any 3rd party http request library (such as Guzzle), or even cURL (https://stackoverflow.com/a/31318117) the same way you would for any other REST API. Sincerely, David B. Tier II API Support Engineer ... View more

Hello,   Your second code sample is the correct way to code the call. I'm wondering if there may be an underlying factor that is causing the error. Please try using our API Tester to get your contact by email address: https://constantcontact.mashery.com/io-docs   If you're getting an error response, please email us at webservices@constantcontact.com with the API Key, Access Token, and the email address you are working with when you get this error so that I can dig in further.   Regards,   David B. Tier II API Support Engineer ... View more

Hello,   There are a variety of reasons you could get a Forbidden response. Examples would be an invalid or missing API key, an inactive API key, invalid or missing authorization header, the access token was revoked, the user account associated with the access token does not have the necessary privileges (e.g. Campaign Creator user role does not have permission for contacts features), or if you are trying to re-add an unsubscribed contact as action_by_owner.   The error response message will contain the details of the error. For example: "error_message": "The contact can not be opted in using 'ACTION_BY_OWNER'." Regards,   David B. Tier II API Support Engineer     ... View more

Hello,   Thank you for reaching out to Constant Contact API Developer Support.   Unfortunately our V2 PHP SDK is not going to work with our V3 API without significant changes. Our V3 API has a completely different schema and requirements. Your best option for using V3 is to manually make your calls.   You can see what the call and response should look like by looking at the Response body and schema here: https://v3.developer.constantcontact.com/api_reference/index.html#!/Contacts/getContacts   You could create a function similar to the example code on our documentation page here: https://v3.developer.constantcontact.com/api_guide/contacts_subresources.html#example-get-request Please have a look and let me know if you have any other questions!   Regards,   David B. Tier II API Support Engineer ... View more