Connecting Your Newsletter

This guide explains how to connect your newsletter to adly.news from various supported platforms. Once connected, your newsletter's subscriber count and engagement metrics will sync automatically.

Supported Platforms

adly.news currently supports:

Platform	Connection Method	Requirements
Beehiiv	API Key	Publication API key
Kit (ConvertKit)	API Key	Account API key
Mailchimp	OAuth	Mailchimp account
The Newsletter Plugin	API Credentials	Base URL, Client Key, Client Secret
GetResponse	API Key	Account API key

Before You Begin

Before connecting your newsletter, have the following ready:

• Access to your newsletter platform's admin/settings area
• Your API key or OAuth credentials
• A logo image for your newsletter (optional but recommended)
• Your newsletter description and audience information

Connecting from Beehiiv

Step 1: Get Your API Key

1. Log in to your Beehiiv account
2. Go to Settings → Integrations
3. Find the API section
4. Click Generate New Key or copy your existing key
5. Copy the API key

Step 2: Connect in adly.news

1. Navigate to Newsletters in your dashboard
2. Click Add Newsletter
3. Select Beehiiv as your platform
4. Paste your API key
5. Click Continue
6. If you have multiple publications, select the one to connect
7. Fill in your newsletter details (see Newsletter Details below)
8. Click Connect Newsletter

Connecting from Kit (ConvertKit)

Step 1: Get Your API Key

1. Log in to your Kit account
2. Go to Settings → Advanced → API
3. Copy your API Secret

Step 2: Connect in adly.news

1. Navigate to Newsletters in your dashboard
2. Click Add Newsletter
3. Select Kit as your platform
4. Paste your API Secret
5. Click Continue
6. Fill in your newsletter details
7. Click Connect Newsletter

Connecting from Mailchimp

Mailchimp uses OAuth for secure connection — no API key copying required.

Step 1: Connect via OAuth

1. Navigate to Newsletters in your dashboard
2. Click Add Newsletter
3. Select Mailchimp as your platform
4. Click Connect with Mailchimp
5. You'll be redirected to Mailchimp's login page
6. Log in to your Mailchimp account
7. Authorize adly.news to access your account
8. You'll be redirected back to adly.news

Step 2: Complete Setup

1. If you have multiple audiences, select which one to connect
2. Fill in your newsletter details
3. Click Connect Newsletter

Connecting from The Newsletter Plugin (WordPress)

Step 1: Get Your API Credentials

1. Log in to your WordPress admin
2. Go to Newsletter → Settings → API
3. Note your:

   • Base URL (your WordPress site URL)
   • Client Key
   • Client Secret

Step 2: Connect in adly.news

1. Navigate to Newsletters in your dashboard
2. Click Add Newsletter
3. Select The Newsletter Plugin as your platform
4. Enter:

   • Base URL (e.g., https://yoursite.com)
   • Client Key
   • Client Secret
   • Newsletter Name
5. Click Continue
6. Fill in your newsletter details
7. Click Connect Newsletter

Connecting from GetResponse

Step 1: Get Your API Key

1. Log in to your GetResponse account
2. Go to Menu → Integrations and API → API
3. Click Generate API Key or copy your existing key
4. Copy the API key

Step 2: Connect in adly.news

1. Navigate to Newsletters in your dashboard
2. Click Add Newsletter
3. Select GetResponse as your platform
4. Paste your API key
5. Click Continue
6. Fill in your newsletter details
7. Click Connect Newsletter

Completing Your Newsletter Profile

After connecting your platform, complete your newsletter profile:

Required Information

Field	Description
Logo	Upload your newsletter's logo (recommended size: 200x200px)
Description	Brief description of your newsletter (what topics you cover)
Audience Description	Describe your typical subscriber (demographics, interests)

Optional Information

Field	Description
Website	Your newsletter's website or landing page
Location	City, state, and country (helps with local advertising)
Target Business Types	Types of businesses ideal for your audience

Tips for a Great Profile

1. Use a professional logo — This is the first thing advertisers see
2. Be specific about your audience — "Tech professionals aged 25-45 interested in AI" is better than "General tech audience"
3. Highlight engagement — If you have strong open rates or click rates, your platform metrics will show this
4. Include your website — Gives advertisers more context about your brand

Managing Connected Newsletters

Viewing Your Newsletters

Navigate to Newsletters to see all connected newsletters with:

• Newsletter name and logo
• Subscriber count
• Open rate and click rate
• Platform
• Connection status

Editing Newsletter Details

1. Go to Newsletters
2. Click Edit on the newsletter you want to update
3. Modify your details
4. Click Save Changes

Re-linking a Newsletter

If your API key becomes invalid or needs to be updated:

1. Go to Newsletters
2. Find the newsletter with connection issues (indicated by a warning icon)
3. Click Re-link
4. Enter your new API credentials
5. Click Update Connection

Syncing Newsletter Data

Your newsletter data syncs automatically. If you need to force a refresh:

1. Go to Newsletters
2. Your subscriber count and metrics will update on the next sync

Troubleshooting

API Key Invalid

If you see an "Invalid API Key" error:

1. Verify you copied the complete API key
2. Check that the key hasn't been revoked in your platform
3. Try generating a new API key
4. Re-link your newsletter with the new key

Connection Failed

If the connection fails:

1. Check your internet connection
2. Verify your platform credentials are correct
3. Ensure your platform account is active
4. Try again in a few minutes

Metrics Not Updating

If subscriber counts or metrics seem outdated:

1. Check your newsletter platform to verify the actual numbers
2. Wait for the next automatic sync (occurs periodically)
3. Contact support if issues persist

Platform Not Listed

If your newsletter platform isn't supported:

1. Navigate to Settings
2. Click Request Platform Support
3. Enter your platform name
4. Submit the request

We regularly add support for new platforms based on user requests.

Next Steps

Once your newsletter is connected:

1. Create your first ad slot to start accepting advertisers
2. Set up payments to receive earnings
3. Browse campaigns to find advertising opportunities