Constant Contact Lead API Documentation

?? Overview

This API acts as a middleware to receive lead data from third-party sources via GET requests and automatically forward them to Constant Contact with proper formatting and custom field mapping.

? Key Features:

? Simple GET request integration - no complex authentication needed
? Automatic token refresh - API handles Constant Contact authentication
? Custom field mapping - automatically maps your custom fields
? No database required - direct passthrough to Constant Contact
? Real-time sync - immediate lead submission

?? API Endpoint

GET https://www.post.autoratefreedom.com/api/leads/submit

?? Parameters

Parameter	Type	Required	Description
`firstName`	string	Required	Contact's first name
`lastName`	string	Optional	Contact's last name
`email`	string	Required	Contact's email address
`phone`	string	Optional	Contact's phone number
`company`	string	Optional	Company name
`jobTitle`	string	Optional	Job title

?? Custom Fields

The following custom fields are available in your Constant Contact account:

Parameter Name	Field ID	Type	Description
`test`	`09c1ecd0-d087-11f0-bf11-0242c4a45550`	string	Test value
`replied`	`f4e490a2-d04e-11f0-afd1-024239ec1c3b`	string	Replied value

?? Example Request

Simple Request (Required fields only):

                    GET https://www.post.autoratefreedom.com/api/leads/submit?firstName=John&email=john@example.com
                

Full Request (All fields):

                    GET https://www.post.autoratefreedom.com/api/leads/submit?firstName=John&lastName=Doe&email=john@example.com&phone=+1-555-1234&company=Acme Corp&jobTitle=Manager&test=value&replied=value
                

?? Success Response:

                    {
  "success": true,
  "message": "Lead submitted successfully to Constant Contact",
  "contactId": "abc-123-def-456",
  "timestamp": "2025-12-04T10:30:00Z"
}
                

? Error Response:

                    {
  "success": false,
  "message": "firstName and email are required parameters",
  "timestamp": "2025-12-04T10:30:00Z"
}
                

?? Authentication

? Automatic Authentication: This API handles all authentication with Constant Contact automatically. Third-party systems don't need to worry about OAuth tokens or API keys.

What happens behind the scenes:

API automatically loads and uses stored Constant Contact credentials
Access tokens are refreshed automatically when expired
No authentication headers needed in requests
Just send lead data via GET request - we handle the rest!

?? Authentication Status

Your Constant Contact account is connected. Token expires in 69356 seconds.

?? Testing

You can test the API directly in your browser by clicking this link:

?? Test API Endpoint

Health Check:

?? Check API Health

?? Integration Guide

For Third-Party Systems:

Collect lead data from your form, CRM, or lead source
Build GET request URL with lead data as query parameters
Send HTTP GET request to /api/leads/submit
Check response for success/failure status
Handle errors if needed (validation, network issues, etc.)

Example Integration (JavaScript):

                    // Send lead to Constant Contact
const leadData = {
  firstName: 'John',
  lastName: 'Doe',
  email: 'john@example.com',
  phone: '+1-555-1234',
  company: 'Acme Corp',
  test: '1',
  replied: '0'
};

const params = new URLSearchParams(leadData);
const response = await fetch(`https://www.post.autoratefreedom.com/api/leads/submit?${params}`);
const result = await response.json();

if (result.success) {
  console.log('Lead submitted!', result.contactId);
} else {
  console.error('Error:', result.message);
}
                

Example Integration (cURL):

                    curl "https://www.post.autoratefreedom.com/api/leads/submit?firstName=John&lastName=Doe&email=john@example.com&phone=+1-555-1234&company=Acme Corp&jobTitle=Manager&test=value&replied=value"
                

? Rate Limits & Best Practices

Rate Limits: Inherited from Constant Contact API (typically 10,000 requests per hour)
Duplicate Handling: Constant Contact automatically handles duplicate emails
Data Validation: API validates required fields before submission
Error Handling: Returns clear error messages for troubleshooting
Logging: All requests are logged for monitoring

?? Constant Contact Lead API

? Authenticated