Constant Contact Email API
Author: f | 2025-04-23
Constant Contact is a popular email marketing software. In this tutorial, I’ll show you how to connect the Constant Contact REST API to Constant Contact API documentation –
Email Campaigns Reporting API - Constant Contact
Get started using the Constant Contact V3 API. To get started using the Constant Contact V3 API, complete the steps that follow. Sign up Register your first application Make your first API calls Learn, discover, troubleshootSTEP 1: Sign upA V3 Constant Contact developer account allows you to create and manage applications in our V3 API ecosystem. When you sign up, a trial Constant Contact account is created that you can use for developing and testing your application integration. In order to use the V3 API, you also need to call into an account that has granted access to the application you are building.To sign up for a new Constant Contact developer account: Open the V3 API Developer Portal . Under the My Applications tab, click Sign up. Provide the following required account information: Email Password First Name Last Name Organization Name Phone Number Click Get Started.STEP 2: Register Your First ApplicationAfter logging in to the V3 Developer Portal using your new developer account, create, register, and manage your Constant Contact V3 API integrations (applications). Click New Application. In the New Application dialog box, enter the name to use to identify your application to Constant Contact users. This is the name that will display when Constant Contact users are prompted to grant access to your application. Applications that integrate with Constant Contact using the V3 API, must use the OAuth2 authorization protocol to securely authenticate a Constant Contact user account, and to be granted access to that user’s data. For details about choosing an OAuth2 flow, see OAuth2 Overview.Choose the OAuth2 setting this application will use to authenticate. Authorization Code Flow and Implicit Flow Proof Key for Code Exchange (PKCE) Flow Device Authorization Flow Choose which refresh token method to use. Use refresh tokens to extend the lifespan of an access token by exchanging it for a new access and refresh token. This eliminates having to request that users log back in to re-authenticate their Constant Contact accounts or reauthorize your application to access their data.For details about choosing which refresh method to use, see OAuth2 Overview. Rotating Refresh tokens are recommended for use with most applications because they are most secure. Long Lived Refresh Tokens Click Create, the My Applications page displays and lists your newly registered application under Applications. To get the API Key (also referred to as a client ID) required for your application to make V3 API calls, click edit next to the new application’s name and the API Key displays in the default Details view. If the authentication method you use requires a client secret to use to authenticate requests made to the Authorization Server, click Generate Client Secret. Copy the secret to a secure location.
Creating an HTML email using the API - Constant Contact
Hello TDulka,Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.You were correct regarding the linked post you shared, in that the error message 'Invalid email address' is typically caused by our compliance system detecting multiple sign ups to several Constant Contact accounts from the email address that caused the error. This issue is not specific to calls made via the API, and can happen with any sign-up form, even those provided directly by Constant Contact. The compliance check is in place to prevent bad or flagged addresses from being added to your account, since if you're frequently sending to bad email addresses, it can start to affect your email's deliverability.I can confirm that all of the addresses that you listed have been detected as having signed up to multiple accounts in a short time causing the system to block sign ups from these addresses. However, if you were testing with these addresses (hence multiple attempts), or if you know the contact that is trying to sign up and that it is a valid address, you should still be able to add them to your contacts manually.If you have further questions about these error messages please feel free to reach out to our Account Review department and they would be happy to answer any concerns you may have. Your case number to reference is 30243227.Contact an Account Review and Delivery Specialist have a look and let us know if you have any other questions! Regards,Courtney E.Tier II API Support EngineerDid I answer your question?If so, please mark my post as an "Accepted Solution" by clicking the Accept as Solution button in the bottom right hand corner of this post.Automated Email Series API Automation - Constant Contact
Response. state — Required. For security, developers use state to encode and securely pass arbitrary string value(s) in the authorization request URL to uniquely identify a user’s session and to prevent cross-site request forgery. You decode the encoded value to verify it is authentic when validating the JWT token. nonce — Required. Specify an arbitrary value. scope — Optional. A list of the scopes that your application requires. The V3 API currently supports the account_read, account_update, contact_data, and campaign_data scopes. Scope names must be space-delimited. For example: {contact_data%20campaign_data%20offline_access}. For more information on scopes and the specific scopes required by each V3 API endpoint, see the Scopes Overview page. Step 2: Get AuthorizationAdd the authorization request to your application to direct users of your application to Constant Constant where they are prompted to sign in to authenticate their user account. Next, Constant Contact displays the Permission Request screen allowing the user to authorize your application to access the Constant Contact data that your application requests.Step 3: Get the Access TokenAfter a user successfully grants your application access to their data, Constant Contact redirects the user to your chosen redirect URI and appends the access token value (access_token) and type (token_type=Bearer) as URL fragments in the authorization response.For example: 4: Validate the Access TokenFor each new access token that you receive, follow best security practices by validating the signature and claims for the access token by completing the procedures that follow.Load the JSON web-key SetUse the method that follows to load the Constant Contact public JSON web-key set used to get the access token./** * This method uses the java11 http client to load Constant Contact's public json web key set. * In real use cases, this value should be cached. * @return Constant Contact's public json web key set for the v3 API. */ public String getPublicJsonWebKeySet() throws IOException { HttpClient httpClient = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder(URI.create(" .GET() .header("Accept","application/json") .header("Content-Type", "application/x-www-form-urlencoded") .build(); HttpResponse httpResponse = httpClient.send(request, HttpResponse.BodyHandlers.ofString()); return httpResponse.body(); }Verify the Access Token ClaimsUse the method that follows to parse the access token, and then validate the signature and claims of the access token. The code examples in this step use the org.jose4j library. Use the jwt parameter to pass in the access token. Use the jsonWebKeySetJson parameter to pass the JSON Web Key Set (JWKS) value (this is the value that was returned in the previous Load the JSON. Constant Contact is a popular email marketing software. In this tutorial, I’ll show you how to connect the Constant Contact REST API to Constant Contact API documentation – Introduction to Constant Contact API. Constant Contact is a powerful email marketing platform that enables businesses to create, send, and track email campaigns withSolved: API - Get Contact ID by Email Address - Constant Contact
Easy to Set-Up There’s so many moving parts in a business, the last thing you need is to spend hours to set up a “time saving integration.” We know that, so we’ve handled all the set up for you!All that’s needed is to sign into your kvCORE and Constant Contact accounts, hit one button and the sync is on. Stand Out in the Inbox, Effortlessly The great thing about email is that it’s easy. The bad thing about email is that it’s ugly. Take a look at this uninspiring message we sent using the standard email setup. Much of the real estate business is about presentation. Making things look beautiful! Email is no exception. Wouldn’t your clients be more interested in receiving something like this? Clients are 80% more likely to read an email with images. Having all your kvCORE leads in Constant Contact makes sending rich messages like this almost too easy. Automate and Move That Real Estate It’s so important to be sending the right message at the right time to the right person. All that can be quickly automated using the kvCORE integration for Constant Contact.You want to automatically send your new leads from the open house a welcome message and then have it followed with a series of messages with listings and advice. Recipe to Email Every New Leadprep time: 5 minCreate a mailing list for “new buyers” in Constant ContactSet up a series of messages in Constant Contact (called an email automation) to be sent when a contact is added to the “new buyers” listSet up your sync from API Nation to grab “buyers” with the preferred source (e.g. ”open house”) and sync them to your list “new buyers” in Constant Contact.Enjoy With this integration, you can specify that any lead that lands in your kvCORE as a buyer from an open house will automatically get a rich series of messages from you. You can also do this for sellers, other agents, vendors etc. Just write those emails once, and have them sent out effortlessly as long as you’d like. Setting yourself apart as a real estate agent can be a whole ‘nother full time job. Email is a huge opportunity to do that everday, . Using Constant Contact for your emails ensures that effort will be rewarded. And with the integration syncing Constant Contact to kvCORE those emails will literally send themselves. Join us in API Nation, where we work smarter.Solved: Email address for Constant Contact? - Constant Contact
The secret only appears once, when you first request to generate it. Regenerating the secret would require you to update your application. Click Save to save any changes to your application.You can return to the applications details page at anytime to get the API key, add or change details, and to generate a client_secret when you’re ready to start developing or making test calls using an HTTP client such as Postman.Developers are limited to a total of 50 applications.Learn more.STEP 3: Make Your First API CallNow you’re ready to make your first API call using the API Reference. The API Reference is a comprehensive, interactive reference of all the V3 endpoints, methods, properties and parameters. You can also make authenticated API calls to your Constant Contact account right in the API Reference. Learn more.Get All Contacts in Your AccountYour first API call will retrieve all the contacts currently in your Constant Contact account. A new account is populated with your contact information upon creation. Navigate to the GET Contacts Collection page in the API Reference. Review the description, parameters, response sample and schema for this endpoint and method. Scroll down to the Try button just after the parameters section. Authenticate - in order to make a call, you have to grant the API Reference access to your account. Click to authenticate and grant access to the API Reference. You’re authenticated if the button reads “signout”. Click . If yours is a brand new Constant Contact account, you should only see one contact in the response - you! If you see a 401 Unauthorized response, you need to authenticate by clicking . Next Step - Add ContactsThe next step is to add contacts to your Constant Contact account. We’re going to add contacts by importing a CSV file with the contact information exported from your email application. You will need to the following to import contacts to your account using a CSV file: a properly formatted CSV file a list_id to which the imported contacts will be addedExport Contacts to a CSV File Export a set of contacts from your email tool to a comma separated value formatted file. If you use Gmail, export to an Outlook CSV formatted file. Clean up the CSV file to fit the requirements for column names and contact data that we accept. Learn more.Get a list_id for the importYou’ll need to specify a list to which to add the new contacts when importing. Here we’ll retrieve a list_id from your account to use. Go to the GET Lists Collection endpoint in the API Reference. Click . You should still be authenticated to your account - check the button - if it reads signout, you’re authenticated.About Constant Contact's APIs
Describes the Implicit Flow. For all public clients (native and single-page applications), such as client-side JavaScript applications and mobile applications, rather than using the OAuth2 Implicit Flow to authorize your application, Constant Contact strongly recommends using the more secure PKCE flow. However, you may choose to use the Implicit Flow if you are unable to use the PKCE Flow.In order to use this flow, you must first create and configure a V3 API application. For more information, see the Quick Start Guide.To authorize your application to access a user’s Constant Contact data, you must create an authorization request and add it to your application’s code. When a user logs in to your application, the authorization request is used to direct the user to Constant Contact to authenticate their user account and to authorize your application to use their Constant Contact data.After the user successfully grants your application access to their data, Constant Contact redirects the user to your chosen redirect URI and appends the access token. Your application uses the access token to make V3 API requests to get the user’s Constant Contact data. Your V3 API requests must include the access token in the Authorization request header. The OAuth2 Implicit Flow does not use your application secret.Unlike the Authorization Code and PKCE Flows, the Implicit Flow does not use refresh tokens. When an access token expires, users must reauthorize your application with Constant Contact. Access tokens automatically expire after 480 minutes (28,800 seconds). Access tokens have a maximum lifetime of 8 hours.To use the Implicit Flow for authorization, complete the steps that follow.Create the authorization request used to direct users to Constant Contact to authenticate their user account and to authorize your application to access their Constant Contact data.To create an authorization request, make a GET request to the authorization endpoint and include all required request query parameters: example, the following shows an encoded URL authorization request: string value(s)}&nonce={encoded string value}&scope={contact_data%20campaign_data}Request Parameters client_id — Required. The API key for your application. You can view the API keys for all of your applications or create a new application on the My Applications page. redirect_uri — Required. The absolute URI that Constant Contact redirects the user to after they grant access to your application. Wildcards are not supported except at the domain root level. response_type — Required. This flow uses the token value to return a bearer token value in theAPI Call with Email address is invalid Return - Constant Contact
Hello LisaJ8997,Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.Our API is not able to directly retrieve opt outs from after a certain date.The "updated_at" value displayed for contacts in the section beginning with "create_source" refers to the last time the contact details were updated. As you can see in the Response Schema example in the right-hand side of the API Reference Page, this is grouped in with other contact details such as name and address. These are stored in a different area of the database than the "updated_at" for "email_address" details, which includes the "opt_out_date". API Reference Page - GET Contacts Collection “updated_after” query parameter that can be used with the Contacts endpoint only applies to the "updated_at" value that identifies who last updated the contact’s personal information, and the "update_source" will only appear for contacts who’s contact information has been updated since they were added (examples: "first_name", "last_name", "job_title", "company_name", "birthday_month", etc…).The "updated_at" value that displays for email addresses in the section starting with "contact_id" does reflect when an email address unsubscribes or is put into another status, but there’s not a parameter available for narrowing by this value when making calls. You can only query for the "updated_at" value for when contact details were last updated.If you just want the last 500 unsubscribes, you’d want to shorten your request to: order to retrieve opt outs after a certain date, your best option would be to send a GET call to the Contacts endpoint with the status parameter set to OPTOUT and then program your application to parse the results and display only values within the desired range as the API cannot call them directly. { "contact_id": "email_address": { "address": "permission_to_send": "created_at": "updated_at": This identifies the last time the status of the contact was updated (if "permission_to_send" changes), and there is not a direct parameter in the API that can call this value, it is just included in the response when making other calls. "opt_out_source": "opt_out_date": "opt_out_reason": "confirm_status": }, "update_source": This identifies who last updated the contact’s personal information. The "update_source" value will only appear for contacts who’s contact information has been updated since they were added (examples: "first_name", "last_name", "job_title", "company_name", "birthday_month", etc…) "create_source": "created_at": "updated_at": The “updated_after” query parameter only applies to this value. The "updated_at" value here only applies to when a contact’s personal information was last updated (examples: "first_name", "last_name", "job_title", "company_name", "birthday_month", etc…) }Please have a look and let us know if you have any other questions! Regards,Courtney E.Tier II API Support EngineerDid I answer your question?If so, please mark my post as an. Constant Contact is a popular email marketing software. In this tutorial, I’ll show you how to connect the Constant Contact REST API to Constant Contact API documentation – Introduction to Constant Contact API. Constant Contact is a powerful email marketing platform that enables businesses to create, send, and track email campaigns with
Compare Constant Contact vs. Infobip Email API - G2
Hello Osman,Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.All information regarding Constant Contact's API can be found within The Constant Contact Developer Portal. Constant Contact provides all developers with free access to our V3 API endpoints for building their own application for integration. All active account types, including trial , have free access to Constant Contact's public API. You can get started using our API by visiting our documentation here: we don't have dedicated developer/sandbox accounts per se, you are able to create a free developer trial account with limited sending capabilities which you can use for your testing purposes. Trial accounts created through the developer portal do not expire, whereas standard trial accounts created through the main site expire after 60 days if not converted to a paid account. Below is a link to our developer portal where you can sign up for a trial account, you'll just need to click on "Sign up".Constant Contact Developer Portal with most APIs, our API has rate limits to help maintain stability and security. Our standard API key access has a rate limit of 10,000 calls per day, and 4 calls per second. Once a key has hit its limit, your calls will return a 429 error until the next day (or the next second if going over your queries-per-second limit).429: Too Many Requests If you are planning on making an application that would be available and potentially used by a large base of customers then I would suggest you look into becoming a Technology Partner with Constant Contact. There is no price involved with this (though your application must be approved) and the basics are to just create and maintain your app, though there are other parts to it. Members of our partner program are given 250,000 calls per day and up to 10 calls per second. To associate your API Key with a partnership, you can look into becoming a Technology Partner: I am uncertain as to the turnaround timesSolved: Automated Email Series API Automation - Constant Contact
Need to have the right tools in place. And in this part of the post, you’ll learn about the tools you’ll need and how you can add interactive elements to your email marketing. 1. Use a solid email marketing service providerTo start with, you need to use a proven email marketing provider like Constant Contact. With Constant Contact’s email marketing platform, you can easily manage your email list, personalize your email content, and make it interactive too. When you select the right email marketing provider, you’ll ensure that your emails get delivered. And you’ll have access to reporting features and more that will help you improve your marketing campaigns.2. Embed videos and GIFsIf you’ve never sent an interactive email before, then start with a video or GIF. With Constant Contact, all you have to do is add a YouTube video to your email by simply copying and pasting. Constant Contact makes it easy to just copy and paste videos into your emails. Image Source: Constant ContactIf you’ve never created a GIF before, don’t worry, it’s actually pretty easy. You can use a tool like Giphy to easily turn your photos or videos into GIFs. Videos will keep your readers engaged longer and GIFs are sure to surprise and excite.3. Use Constant Contact’s Surveys and Polls featureAsking your audience for their feedback or preferences is easy with Constant Contact’s Survey and Poll feature. Just drag the block you need to make a poll or survey. Image Source: Constant ContactAll you need to do is add a block to your email body and fill in the right information.You can use pre-written questions or write your own, choose from multiple different question types like multiple choice and sliding scales, customize the logo and colors to match your brand, and embed them inside your emails. 4. Build event invites One of the reasons why Constant Contact is a great email marketing tool is that it has drag and drop builders. Meaning you don’t have to be a technical expert to create gorgeous and engaging emails. Image Source: Constant ContactAdd an event invite with a block and include an RSVP button that links to a custom registration form so that your subscribers don’t have to jump through hoops to RSVP to your event. You also have the option of including social buttons so invitees can share the event with their friends.5. Use interactive tools beyond the email itselfYou can encourage users to click through your emails to take them to even more robust interactive experiences. Building images with clickable icons, popup text, and videos doesn’t have to be hard. There are online platforms like Thinglink that easily turn your regular images into interactive ones. You. Constant Contact is a popular email marketing software. In this tutorial, I’ll show you how to connect the Constant Contact REST API to Constant Contact API documentation – Introduction to Constant Contact API. Constant Contact is a powerful email marketing platform that enables businesses to create, send, and track email campaigns withv3 api returns Email address is invalid for no - Constant Contact
Who is this software for? Constant Contact is ideal for any size business Pros Free for 60 daysEasy gmail and outlook email importsNo contracts. Cancel anytime. Cons Storage limitationsLimited auto-repsonder Screenshots Pricing For 2.5k contacts $55 / month For 10k contacts $80 / month For 25k contacts $155 / month For 100k contacts Contact sales Full feature pricing Get a quote Starting price Free Setup fee None Starting # of users 1 User Cost per extra user Contact sales Refund policy Yes Free demo Ratings Features Lead scoring Lead segmentation Web activity tracking SMS marketing Personalize web content Predictive analytics Bi-directional CRM syncing Event management Create invoices Create quotes Split testing Create membership sites Bulk social media posting Sales reports Real-time sales alerts Mobile app Social CRM Integrations Outlook integration Gmail integration Salesforce integration SAP integration Oracle integration Netsuite integration SugarCRM integration Microsoft Dynamics integration Zapier integration General Info HQ Location United States Founded in 1995 Alternatives About Constant Contact Constant Contact makes email marketing easier by simplifying the process of creating a customized email that matches your branding with their easy to use email editor and customizable templates. Easily import your pre existing list or build one using their sign up forms. Create and schedule your emails so they are automatically sent people who join your lists and meet your custom triggers. With Constant Contact you can transform your emails into social media posts so you can reach your fans wherever they are.Constant Contact also offer a full service email marketing service to get your email marketing campaigns off the ground. Who is this software for? ConvertKit is ideal for bloggers Pros The power of Infusionsoft, but easier to use than MailChimp.Landing pagesCustom white glove migration Cons No live chat supportNo A/B testing Screenshots Pricing For 2.5k contacts $41Comments
Get started using the Constant Contact V3 API. To get started using the Constant Contact V3 API, complete the steps that follow. Sign up Register your first application Make your first API calls Learn, discover, troubleshootSTEP 1: Sign upA V3 Constant Contact developer account allows you to create and manage applications in our V3 API ecosystem. When you sign up, a trial Constant Contact account is created that you can use for developing and testing your application integration. In order to use the V3 API, you also need to call into an account that has granted access to the application you are building.To sign up for a new Constant Contact developer account: Open the V3 API Developer Portal . Under the My Applications tab, click Sign up. Provide the following required account information: Email Password First Name Last Name Organization Name Phone Number Click Get Started.STEP 2: Register Your First ApplicationAfter logging in to the V3 Developer Portal using your new developer account, create, register, and manage your Constant Contact V3 API integrations (applications). Click New Application. In the New Application dialog box, enter the name to use to identify your application to Constant Contact users. This is the name that will display when Constant Contact users are prompted to grant access to your application. Applications that integrate with Constant Contact using the V3 API, must use the OAuth2 authorization protocol to securely authenticate a Constant Contact user account, and to be granted access to that user’s data. For details about choosing an OAuth2 flow, see OAuth2 Overview.Choose the OAuth2 setting this application will use to authenticate. Authorization Code Flow and Implicit Flow Proof Key for Code Exchange (PKCE) Flow Device Authorization Flow Choose which refresh token method to use. Use refresh tokens to extend the lifespan of an access token by exchanging it for a new access and refresh token. This eliminates having to request that users log back in to re-authenticate their Constant Contact accounts or reauthorize your application to access their data.For details about choosing which refresh method to use, see OAuth2 Overview. Rotating Refresh tokens are recommended for use with most applications because they are most secure. Long Lived Refresh Tokens Click Create, the My Applications page displays and lists your newly registered application under Applications. To get the API Key (also referred to as a client ID) required for your application to make V3 API calls, click edit next to the new application’s name and the API Key displays in the default Details view. If the authentication method you use requires a client secret to use to authenticate requests made to the Authorization Server, click Generate Client Secret. Copy the secret to a secure location.
2025-04-02Hello TDulka,Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.You were correct regarding the linked post you shared, in that the error message 'Invalid email address' is typically caused by our compliance system detecting multiple sign ups to several Constant Contact accounts from the email address that caused the error. This issue is not specific to calls made via the API, and can happen with any sign-up form, even those provided directly by Constant Contact. The compliance check is in place to prevent bad or flagged addresses from being added to your account, since if you're frequently sending to bad email addresses, it can start to affect your email's deliverability.I can confirm that all of the addresses that you listed have been detected as having signed up to multiple accounts in a short time causing the system to block sign ups from these addresses. However, if you were testing with these addresses (hence multiple attempts), or if you know the contact that is trying to sign up and that it is a valid address, you should still be able to add them to your contacts manually.If you have further questions about these error messages please feel free to reach out to our Account Review department and they would be happy to answer any concerns you may have. Your case number to reference is 30243227.Contact an Account Review and Delivery Specialist have a look and let us know if you have any other questions! Regards,Courtney E.Tier II API Support EngineerDid I answer your question?If so, please mark my post as an "Accepted Solution" by clicking the Accept as Solution button in the bottom right hand corner of this post.
2025-03-31Easy to Set-Up There’s so many moving parts in a business, the last thing you need is to spend hours to set up a “time saving integration.” We know that, so we’ve handled all the set up for you!All that’s needed is to sign into your kvCORE and Constant Contact accounts, hit one button and the sync is on. Stand Out in the Inbox, Effortlessly The great thing about email is that it’s easy. The bad thing about email is that it’s ugly. Take a look at this uninspiring message we sent using the standard email setup. Much of the real estate business is about presentation. Making things look beautiful! Email is no exception. Wouldn’t your clients be more interested in receiving something like this? Clients are 80% more likely to read an email with images. Having all your kvCORE leads in Constant Contact makes sending rich messages like this almost too easy. Automate and Move That Real Estate It’s so important to be sending the right message at the right time to the right person. All that can be quickly automated using the kvCORE integration for Constant Contact.You want to automatically send your new leads from the open house a welcome message and then have it followed with a series of messages with listings and advice. Recipe to Email Every New Leadprep time: 5 minCreate a mailing list for “new buyers” in Constant ContactSet up a series of messages in Constant Contact (called an email automation) to be sent when a contact is added to the “new buyers” listSet up your sync from API Nation to grab “buyers” with the preferred source (e.g. ”open house”) and sync them to your list “new buyers” in Constant Contact.Enjoy With this integration, you can specify that any lead that lands in your kvCORE as a buyer from an open house will automatically get a rich series of messages from you. You can also do this for sellers, other agents, vendors etc. Just write those emails once, and have them sent out effortlessly as long as you’d like. Setting yourself apart as a real estate agent can be a whole ‘nother full time job. Email is a huge opportunity to do that everday, . Using Constant Contact for your emails ensures that effort will be rewarded. And with the integration syncing Constant Contact to kvCORE those emails will literally send themselves. Join us in API Nation, where we work smarter.
2025-04-05The secret only appears once, when you first request to generate it. Regenerating the secret would require you to update your application. Click Save to save any changes to your application.You can return to the applications details page at anytime to get the API key, add or change details, and to generate a client_secret when you’re ready to start developing or making test calls using an HTTP client such as Postman.Developers are limited to a total of 50 applications.Learn more.STEP 3: Make Your First API CallNow you’re ready to make your first API call using the API Reference. The API Reference is a comprehensive, interactive reference of all the V3 endpoints, methods, properties and parameters. You can also make authenticated API calls to your Constant Contact account right in the API Reference. Learn more.Get All Contacts in Your AccountYour first API call will retrieve all the contacts currently in your Constant Contact account. A new account is populated with your contact information upon creation. Navigate to the GET Contacts Collection page in the API Reference. Review the description, parameters, response sample and schema for this endpoint and method. Scroll down to the Try button just after the parameters section. Authenticate - in order to make a call, you have to grant the API Reference access to your account. Click to authenticate and grant access to the API Reference. You’re authenticated if the button reads “signout”. Click . If yours is a brand new Constant Contact account, you should only see one contact in the response - you! If you see a 401 Unauthorized response, you need to authenticate by clicking . Next Step - Add ContactsThe next step is to add contacts to your Constant Contact account. We’re going to add contacts by importing a CSV file with the contact information exported from your email application. You will need to the following to import contacts to your account using a CSV file: a properly formatted CSV file a list_id to which the imported contacts will be addedExport Contacts to a CSV File Export a set of contacts from your email tool to a comma separated value formatted file. If you use Gmail, export to an Outlook CSV formatted file. Clean up the CSV file to fit the requirements for column names and contact data that we accept. Learn more.Get a list_id for the importYou’ll need to specify a list to which to add the new contacts when importing. Here we’ll retrieve a list_id from your account to use. Go to the GET Lists Collection endpoint in the API Reference. Click . You should still be authenticated to your account - check the button - if it reads signout, you’re authenticated.
2025-04-08Hello LisaJ8997,Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.Our API is not able to directly retrieve opt outs from after a certain date.The "updated_at" value displayed for contacts in the section beginning with "create_source" refers to the last time the contact details were updated. As you can see in the Response Schema example in the right-hand side of the API Reference Page, this is grouped in with other contact details such as name and address. These are stored in a different area of the database than the "updated_at" for "email_address" details, which includes the "opt_out_date". API Reference Page - GET Contacts Collection “updated_after” query parameter that can be used with the Contacts endpoint only applies to the "updated_at" value that identifies who last updated the contact’s personal information, and the "update_source" will only appear for contacts who’s contact information has been updated since they were added (examples: "first_name", "last_name", "job_title", "company_name", "birthday_month", etc…).The "updated_at" value that displays for email addresses in the section starting with "contact_id" does reflect when an email address unsubscribes or is put into another status, but there’s not a parameter available for narrowing by this value when making calls. You can only query for the "updated_at" value for when contact details were last updated.If you just want the last 500 unsubscribes, you’d want to shorten your request to: order to retrieve opt outs after a certain date, your best option would be to send a GET call to the Contacts endpoint with the status parameter set to OPTOUT and then program your application to parse the results and display only values within the desired range as the API cannot call them directly. { "contact_id": "email_address": { "address": "permission_to_send": "created_at": "updated_at": This identifies the last time the status of the contact was updated (if "permission_to_send" changes), and there is not a direct parameter in the API that can call this value, it is just included in the response when making other calls. "opt_out_source": "opt_out_date": "opt_out_reason": "confirm_status": }, "update_source": This identifies who last updated the contact’s personal information. The "update_source" value will only appear for contacts who’s contact information has been updated since they were added (examples: "first_name", "last_name", "job_title", "company_name", "birthday_month", etc…) "create_source": "created_at": "updated_at": The “updated_after” query parameter only applies to this value. The "updated_at" value here only applies to when a contact’s personal information was last updated (examples: "first_name", "last_name", "job_title", "company_name", "birthday_month", etc…) }Please have a look and let us know if you have any other questions! Regards,Courtney E.Tier II API Support EngineerDid I answer your question?If so, please mark my post as an
2025-04-07