Skip to main content
POST
/
api
/
v1
/
external
/
subscribers
curl -X POST "https://api.mailgreet.com/api/v1/external/subscribers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "group_ids": ["550e8400-e29b-41d4-a716-446655440000"],
    "custom_fields": {
      "company": "Acme Inc",
      "role": "Marketing Manager"
    }
  }'

{
  "success": true,
  "data": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "status": "active",
    "created_at": "2026-01-18T12:00:00Z"
  }
}

​
Overview

Create a new subscriber in your MailGreet account. The subscriber will be added with an active status by default and can optionally be assigned to one or more groups.
This endpoint respects your plan’s subscriber limits. If you’ve reached your limit, a 403 Forbidden error will be returned.

​
Authentication

​
Authorization
string
required
Bearer token. Format: Bearer YOUR_API_KEY

​
Request Body

​
email
string
required
A valid email address for the subscriber. Must be unique within your account.
​
first_name
string
The subscriber’s first name.
​
last_name
string
The subscriber’s last name.
​
phone
string
The subscriber’s phone number. Recommended format: +1234567890
​
group_ids
array
An array of group UUIDs to add the subscriber to.Example: ["550e8400-e29b-41d4-a716-446655440000"]
​
custom_fields
object
An object containing custom field key-value pairs. Keys must match your defined custom fields.Example: {"company": "Acme Inc", "role": "Developer"}

​
Response

​
success
boolean
Indicates if the subscriber was created successfully
​
data
object
curl -X POST "https://api.mailgreet.com/api/v1/external/subscribers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "group_ids": ["550e8400-e29b-41d4-a716-446655440000"],
    "custom_fields": {
      "company": "Acme Inc",
      "role": "Marketing Manager"
    }
  }'

{
  "success": true,
  "data": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "status": "active",
    "created_at": "2026-01-18T12:00:00Z"
  }
}