MyEmailProgram API Documentation

Contact lists

GET /api/getLists

Returns your contact lists, including each list’s ID and subscriber count. You’ll need a list’s ID to add contacts to it.

curl "https://app.myemailprogram.com/api/getLists" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /api/addList

Creates a new contact list.

Contacts

POST /api/addContact

Adds a contact to a list. Include custom fields, such as first and last name, by their field names.

Adding an address that already exists on the list returns an error (“Email address already exists”). Use updateContactByEmail to change an existing contact. Call getCustomFields to see the exact names of your custom fields.

curl -X POST "https://app.myemailprogram.com/api/addContact" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": 12,
    "email": "[email protected]",
    "first_name": "Sam",
    "last_name": "Carter",
    "response": 1
  }'

GET /api/getContacts

Finds contacts. Combine filters to narrow the results.

curl "https://app.myemailprogram.com/api/getContacts?list_id=12&full_details=1&limit_count=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /api/getContact/{id}

Returns a single contact by contact ID, including subscription status and custom field values.

PUT /api/updateContactByEmail/{email}

Updates a contact using their email address, which is usually easier than looking up an ID first.

Only resubscribe someone who has asked to be resubscribed.

curl -X PUT "https://app.myemailprogram.com/api/updateContactByEmail/[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "list_id": 12, "first_name": "Samantha" }'

PUT /api/markAsUnsubscribed/{id}

Marks a contact as unsubscribed by contact ID. Use this to honor opt-outs that come from another system, like a checkout page or CRM.

DELETE /api/deleteContactByEmail/{email}/{recursive}

Deletes a contact by email address. Set recursive to 1 to delete the address from every list, or 0 to delete only the first match.

Deleting a contact removes their record. To stop emailing someone who opted out, unsubscribe or suppress them instead, so they can’t be re-imported by accident.

Suppression

Suppressed addresses are never sent to, even if they’re on a list. Hard bounces, spam complaints, and unsubscribes are suppressed automatically. Use these endpoints to add your own. Read Bounces and Suppression Lists for the full picture.

POST /api/suppress

Adds an email address, a whole domain, or an IP address to suppression, either account-wide or for one list.

curl -X POST "https://app.myemailprogram.com/api/suppress" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": 0,
    "reference": "Requested removal by phone",
    "email": "[email protected]"
  }'

GET /api/getSuppressed

Lists suppressed entries.

Broadcasts and scheduling

GET /api/getBroadcasts

Lists your broadcasts (saved email campaigns), including subject lines and content.

POST /api/addBroadcast

Creates a broadcast. This saves the email. It doesn’t send it.

The campaign editor’s Pre-header field isn’t available through the API, so build your preheader (inbox preview text) directly into content_html. Our preheader guide has a copy-and-paste snippet.

curl -X POST "https://app.myemailprogram.com/api/addBroadcast" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "group_name": "Newsletters",
    "broadcast_name": "November Newsletter",
    "email_subject": "New Class Dates Are Up",
    "content_html": "<p>Our winter class dates are posted.</p>",
    "content_text": "Our winter class dates are posted.",
    "response": 1
  }'

POST /api/broadcastSchedule

Schedules one or more broadcasts to one or more lists, either now or at a set time.

Always schedule a small test send to yourself before sending to a full list. Turning on unsubscribe_headers adds the one-click unsubscribe headers Gmail and Yahoo expect. Learn more in List-Unsubscribe Headers.

curl -X POST "https://app.myemailprogram.com/api/broadcastSchedule" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "November Newsletter - Main List",
    "type": "subscriber",
    "broadcast_ids": "45",
    "list_ids": "12",
    "smtp_ids": "3",
    "smtp_sequence": "batch",
    "sending_pattern": "sequential",
    "sending_time": "later",
    "send_datetime": "2026-11-05 09:00:00",
    "sender_type": "list",
    "track_opens": 1,
    "track_clicks": 1,
    "unsubscribe_headers": 1
  }'

Reporting

GET /api/getBroadcastStatsSummary/{schedule_id}

Returns the results of a scheduled send: total contacts, sent, opens, clicks, click-through rate, bounces, and unsubscribes, plus start and finish times.

The schedule_id is the ID returned when you schedule a broadcast, or the ID shown for that send in your account.

curl "https://app.myemailprogram.com/api/getBroadcastStatsSummary/195" \
  -H "Authorization: Bearer YOUR_API_KEY"

Using the API with AI tools

The API is how you connect MyEmailProgram to the AI tool of your choice to analyze campaign reports, summarize results, or help draft and build emails. A few tips:

• Create a separate key for each tool. That way you can see what each one does and turn one off without affecting the others.
• Give each key only what it needs. A key used for reporting and analysis doesn’t need permission to create or schedule broadcasts. Add permissions later if you need them.
• Keep a human in the loop for sending. Let AI draft and build, then review before anything is scheduled to a real list.

See API & AI Integrations for more ideas.

Need help?

If you’re stuck on a request, send us the endpoint, the request body (with your API key removed), and the response you got back. That’s usually enough for us to spot the problem. Customers can reach Jacob directly. Everyone else can use our contact form.