You can manage all your email service provider (ESP) integrations under Account → Integrations.

EmailOctopus Integration

Connect your Newsletter Surveys in FeedLetter to your EmailOctopus account to automatically fetch sending stats and display them on your surveys.

Available with Professional and Business plans.

Steps to Connect

1. Go to the EmailOctopus API Keys page.

2. Generate a new API key for the v2 API.

   • ⚠️ Important: Copy and store the API key somewhere safe—you’ll only see it once.

3. Go to FeedLetter Integrations.

4. Click Add Integration.

5. Choose EmailOctopus from the list.

6. Give the integration a meaningful name (e.g. “Weekly Newsletter Stats”).

7. Paste your EmailOctopus API key into the API Key field.

8. Click Create.

9. FeedLetter will validate the API key and connect if it’s correct.

Generic Pull API Integration

If you use a custom email backend or unsupported ESP, you can still show sending stats on your surveys using our Generic Pull API.

Available with Business plan.

Overview

FeedLetter will send a list of survey and poll IDs to your API. Your backend should respond with stats (sent, opens, clicks) for each known item.

Authentication

The request includes an Authorization header using Bearer token authentication:

Authorization: Bearer YOUR_API_TOKEN

Request Format

FeedLetter sends a JSON array of survey/poll IDs in the request body.

Example Request

[
  "8f2e7d1c-5b4a-42f1-9e8d-3a6b5c7d8e9f",
  "2a1b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
  "3a1b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
]

Expected Response Format

Your API should return a JSON object where keys are FeedLetter IDs, and values contain the email stats.

Fields per Survey/Poll:

• email_id – ID of the email in your backend
• email_name – Human-readable name of the email
• sent – Number of emails sent (-1 if unavailable)
• opened – Number of emails opened (-1 if unavailable)
• clicked – Number of clicks (-1 if unavailable)

If your backend has no stats for a given ID, simply omit it from the response.

Example Response

{
  "8f2e7d1c-5b4a-42f1-9e8d-3a6b5c7d8e9f": {
    "email_id": "em_12345",
    "email_name": "Weekly Newsletter",
    "sent": 5000,
    "opened": 2500,
    "clicked": 1200
  },
  "2a1b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d": {
    "email_id": "em_67890",
    "email_name": "Product Launch",
    "sent": 10000,
    "opened": 4800,
    "clicked": 3200
  },
  "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f": {
    "email_id": "em_54321",
    "email_name": "Special Offer",
    "sent": 7500,
    "opened": 3600,
    "clicked": 2100
  }
}