API Access

Programmatic access to PenguinMails features via a RESTful API

Overview

The PenguinMails API allows developers to integrate email capabilities directly into their applications. Everything you can do in the dashboard, you can do via the API.

Base URL: https://api.penguinmails.com/v1

Key Capabilities

  • Send Emails - Transactional and bulk sending

  • Manage Contacts - Sync leads from your CRM

  • Retrieve Analytics - Pull reports into your dashboard

  • Webhooks - Real-time event notifications

Authentication

We use Bearer Token authentication.

  1. Generate an API Key in Settings → API Keys.

  2. Include it in the Authorization header.

curl -X GET https://api.penguinmails.com/v1/campaigns \
  -H "Authorization: Bearer pm_live_12345..."

Rate Limiting

Limits are applied per tenant based on your subscription plan.

Plan Rate Limit Burst
Starter 60 req/min 100
Professional 300 req/min 500
Business 1000 req/min 2000

Headers

  • X-RateLimit-Limit: Total requests allowed

  • X-RateLimit-Remaining: Requests left in window

  • X-RateLimit-Reset: Time until reset

Core Endpoints

Emails

Send a single email 

POST /emails/send
{
  "to": "user@example.com",
  "template_id": "welcome-v1",
  "variables": { "name": "Alice" }
}

Contacts

Add or update a contact 

POST /contacts
{
  "email": "lead@example.com",
  "attributes": { "source": "signup_form" }
}

Campaigns

List campaigns 

GET /campaigns?status=sent&limit=10

SDKs & Libraries

Official client libraries are coming soon:

  • Node.js (Q1 2026)

  • Python (Q1 2026)

  • PHP (Q2 2026)

Route Specifications

Feature Documentation

API Documentation

Architecture & Security

Implementation

Last Updated: November 24, 2025 Version: v1

Build powerful email integrations with the PenguinMails API.