> For the complete documentation index, see [llms.txt](https://adly-news.gitbook.io/adly.news-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adly-news.gitbook.io/adly.news-docs/02-newsletter-owners/01-connecting-newsletters.md).

# Connecting Your Newsletter

This guide explains how to connect your newsletter to [adly.news](https://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](#completing-your-newsletter-profile) 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](/adly.news-docs/02-newsletter-owners/02-creating-ad-slots.md) to start accepting advertisers
2. [Set up payments](/adly.news-docs/02-newsletter-owners/09-payments-and-payouts.md) to receive earnings
3. [Browse campaigns](/adly.news-docs/02-newsletter-owners/05-browsing-campaigns.md) to find advertising opportunities


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://adly-news.gitbook.io/adly.news-docs/02-newsletter-owners/01-connecting-newsletters.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.