Skip to main content
The Newsletter Referral API provides endpoints for managing newsletter subscriber referral programs.

Key Concepts

  • Subscriber: A newsletter subscriber who can share referral links
  • Referred Subscriber: A new subscriber who signed up via a referral link
  • Rewards: Benefits earned when referrals reach milestones

Available Endpoints

Program Overview

Get newsletter program details:
GET https://api.partnero.com/v1/program
{
  "data": {
    "id": "HTA1FEFM",
    "name": "My Newsletter Program",
    "esp_type": "custom",
    "esp_type_name": "Custom",
    "total_subscribers": 1,
    "total_referring": 0,
    "total_referred": 0,
    "created_at": "2025-04-30T15:15:12.000000Z"
  },
  "status": 1
}

ESP Integration

Newsletter programs can integrate with Email Service Providers:
  • Custom - Manual subscriber management
  • Mailchimp - Automatic sync with Mailchimp
  • MailerLite - Automatic sync with MailerLite
  • Kit (ConvertKit) - Automatic sync with Kit
  • Beehiiv - Automatic sync with Beehiiv