Email API Documentation

Email management endpoints for creating, updating, previewing, and managing email content, templates, and attachments.

Create an Email

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.create`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.create",
    "SessionID": "your-session-id"
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "EmailID": 12345
}

json

{
  "Success": false,
  "ErrorCode": [1, 2, 3]
}

txt

0: Success

Get Email Details

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.get`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID to retrieve

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.get",
    "SessionID": "your-session-id",
    "EmailID": 12345
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "EmailInformation": {
    "EmailID": 12345,
    "EmailName": "Newsletter",
    "Subject": "Monthly Update",
    "HTMLContent": "<html>...</html>",
    "PlainContent": "...",
    "FromName": "Company Name",
    "FromEmail": "info@company.com"
  }
}

json

{
  "Success": false,
  "ErrorCode": [1, 2]
}

txt

0: Success
1: Missing required parameter EmailID
2: Email not found or access denied

Get Emails (List or Bulk by IDs)

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

This endpoint operates in two modes:

Legacy list mode (no EmailIDs parameter) — returns every email the calling user owns. Per-row shape is the raw database row: Options is a JSON string, no Attachments key. Default order: EmailName ASC.
Bulk-by-IDs mode (with EmailIDs parameter) — returns only the requested rows that the calling user owns. Per-row shape mirrors email.get: Options is JSON-decoded into an object, and Attachments is attached when the full shape is requested OR when Attachments is explicitly listed in Fields. Soft-deleted rows are excluded. Response order is not guaranteed — re-key by EmailID if order matters. Non-owned and non-existent IDs are silently dropped (compare input length vs. response length to detect drops).

The optional Fields parameter is honored in both modes — additive projection that restricts which keys appear on each returned row.

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `emails.get`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailIDs	String	No	Comma-separated list of email IDs (e.g. `9101,9102,9103`). When omitted, returns all emails owned by the user (legacy mode). When set, switches to bulk-by-IDs mode: blank/non-numeric entries are silently dropped, hard-capped at 100 valid IDs per call.
Fields	String	No	Comma-separated allow-list of fields to project per row. Possible values: `EmailID`, `RelUserID`, `EmailName`, `FromName`, `FromEmail`, `ReplyToName`, `ReplyToEmail`, `ContentType`, `Mode`, `FetchURL`, `FetchPlainURL`, `Subject`, `PlainContent`, `HTMLContent`, `ExtraContent1`, `ExtraContent2`, `ImageEmbedding`, `RelTemplateID`, `PreHeaderText`, `Options`, `IsEmailTemplate`, `CreatedAt`, `UpdatedAt`, `DeletedAt`, `Attachments`. Unknown field names are silently dropped. `EmailID` is always re-added so callers can re-key.

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "emails.get",
    "SessionID": "your-session-id"
  }'

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "emails.get",
    "SessionID": "your-session-id",
    "EmailIDs": "9101,9102,9103",
    "Fields": "EmailID,Subject,Mode,ContentType,UpdatedAt"
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "ErrorText": "",
  "TotalEmailCount": 2,
  "Emails": [
    {
      "EmailID": 9101,
      "Subject": "Welcome aboard",
      "Mode": "Editor",
      "ContentType": "Both",
      "UpdatedAt": "2026-05-02 18:11:07"
    },
    {
      "EmailID": 9102,
      "Subject": "Day-3 tips",
      "Mode": "Stripo",
      "ContentType": "Both",
      "UpdatedAt": "2026-05-03 09:12:14"
    }
  ]
}

json

{
  "Success": false,
  "ErrorCode": [3],
  "ErrorText": ["Too many ids; max 100"]
}

txt

0: Success
1: EmailIDs was provided but contained no valid (numeric, non-blank) entries
3: EmailIDs contained more than 100 valid entries (cap exceeded)

Update an Email

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.update`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID to update
ValidateScope	String	Yes	Validation scope: `OptIn`, `Campaign`, or `AutoResponder`
EmailName	String	No	Email name
Subject	String	No	Email subject
PreHeaderText	String	No	Email preheader text
FromName	String	No	Sender name
FromEmail	String	No	Sender email address
ReplyToName	String	No	Reply-to name
ReplyToEmail	String	No	Reply-to email address
HTMLContent	String	No	HTML email content
PlainContent	String	No	Plain text email content
Mode	String	No	Editor mode: `Unlayer`, `Stripo`, `Editor`, `Empty`, `Template`, `Import`
FetchURL	String	No	URL to fetch HTML content from (for Import mode)
FetchPlainURL	String	No	URL to fetch plain content from (for Import mode)
ImageEmbedding	String	No	Image embedding setting
SenderDomain	String	No	Sender domain. Only enforced when `ValidateScope=Campaign` and the user's group has `SenderDomainManagement=Enabled`; ignored for `OptIn` and `AutoResponder` scopes (transactional traffic).
OpenTracking	Boolean	No	Enable open tracking (default: true)
LinkTracking	Boolean	No	Enable link tracking (default: true)
UTMTracking	Boolean	No	Enable UTM tracking
UTMSource	String	Conditional	UTM source (required if UTMTracking is true)
UTMMedium	String	Conditional	UTM medium (required if UTMTracking is true)
UTMCampaign	String	Conditional	UTM campaign (required if UTMTracking is true)
UTMTerm	String	No	UTM term parameter
UTMContent	String	No	UTM content parameter
UTMMergeTags	Boolean	No	Use merge tags in UTM parameters
RelTemplateID	Integer	Conditional	Template ID (required if Mode is `Template`)
IsEmailTemplate	Integer	No	Mark as email template (0 or 1)
ExtraContent1	String	No	Extra content field 1 (for Stripo/Unlayer)
ExtraContent2	String	No	Extra content field 2 (for Stripo/Unlayer)

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.update",
    "SessionID": "your-session-id",
    "EmailID": 12345,
    "ValidateScope": "Campaign",
    "EmailName": "Updated Newsletter",
    "Subject": "New Monthly Update",
    "HTMLContent": "<html><body>Updated content</body></html>",
    "PlainContent": "Updated content",
    "FromName": "Company Name",
    "FromEmail": "info@company.com",
    "OpenTracking": true,
    "LinkTracking": true
  }'

json

{
  "Success": true,
  "ErrorCode": 0
}

json

{
  "Success": false,
  "ErrorCode": [1, 3, 4, 8, 9, 10, 11, 12, 17, 18, 19, 20]
}

txt

0: Success
1: Missing required parameter EmailID
3: Email not found or access denied
4: Invalid Mode parameter
8: Email content cannot be empty
9: Missing required parameter ValidateScope
10: Invalid ValidateScope parameter (must be OptIn, Campaign, or AutoResponder)
11: Missing unsubscribe link in HTML content
12: Missing unsubscribe link in plain content
17: Invalid sender domain (only raised when ValidateScope=Campaign; OptIn and AutoResponder scopes bypass this check)
18: Missing UTMSource parameter (required when UTMTracking is enabled)
19: Missing UTMMedium parameter (required when UTMTracking is enabled)
20: Missing UTMCampaign parameter (required when UTMTracking is enabled)

Delete an Email

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.delete`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID to delete

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.delete",
    "SessionID": "your-session-id",
    "EmailID": 12345
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "ErrorText": ""
}

json

{
  "Success": false,
  "ErrorCode": [1]
}

txt

0: Success
1: Missing required parameter EmailID

Duplicate an Email

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.duplicate`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID to duplicate

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.duplicate",
    "SessionID": "your-session-id",
    "EmailID": 12345
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "EmailID": 12346,
  "EmailName": "Copy of Newsletter"
}

json

{
  "Success": false,
  "ErrorCode": [1, 2]
}

txt

0: Success
1: Missing required parameter EmailID
2: Email not found or access denied

Send Email Preview

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.emailpreview`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Conditional	Email ID to preview (or provide HTMLContent/PlainContent)
EmailAddress	String	Conditional	Recipient email address (required if SubscriberID not provided)
SubscriberID	Integer	No	Subscriber ID to use for personalization
ListID	Integer	No	List ID for subscriber lookup
CampaignID	Integer	No	Campaign ID for context
HTMLContent	String	Conditional	HTML content (if EmailID not provided)
PlainTextContent	String	Conditional	Plain text content (if EmailID not provided)
FromName	String	No	Override sender name
FromEmailAddress	String	No	Override sender email
Subject	String	No	Override email subject
PreHeaderText	String	No	Override preheader text
ReplyToName	String	No	Override reply-to name
ReplyToEmail	String	No	Override reply-to email
SenderDomain	String	No	Override sender domain
AddUserGroupHeaderFooter	Boolean	No	Add user group header/footer (default: true)
EmailType	String	No	Email type: `optinconfirmation` or regular (default)

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.emailpreview",
    "SessionID": "your-session-id",
    "EmailID": 12345,
    "EmailAddress": "test@example.com",
    "ListID": 100
  }'

json

{
  "Success": true,
  "ErrorCode": 0
}

json

{
  "Success": false,
  "ErrorCode": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
}

txt

0: Success
1: Missing required parameter EmailID
2: Missing required parameter EmailAddress
3: Email not found
4: Invalid email address format
5: Subscriber not found
6: List not found
7: Campaign not found
8: Email delivery failed or sender domain not found
9: Missing required parameter HTMLContent or PlainTextContent
10: Missing required parameter PlainTextContent

Test Email Delivery Settings

POST /api.php

API Usage Notes

Authentication required: Admin API Key
Not available in demo mode
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.delivery.test`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.delivery.test",
    "SessionID": "admin-session-id"
  }'

json

{
  "Success": true
}

json

{
  "Success": false,
  "ErrorCode": "NOT AVAILABLE IN DEMO MODE."
}

txt

1: Email delivery test failed

Test Email Against Spam Filters

POST /api.php

API Usage Notes

Authentication required: User API Key
Required permissions: Email.SpamTest
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.spamtest`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID to test

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.spamtest",
    "SessionID": "your-session-id",
    "EmailID": 12345
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "TestResults": {
    "score": 2.5,
    "tests": [
      {
        "name": "BAYES_00",
        "score": -1.9,
        "description": "Bayes spam probability is 0 to 1%"
      }
    ]
  }
}

json

{
  "Success": false,
  "ErrorCode": [1, 2, 3]
}

txt

0: Success
1: Missing required parameter EmailID
2: Email not found
3: Spam test service error

Render Email in Browser

GET /api/v1/email.render

API Usage Notes

Authentication required: User API Key
Rate limit: 10000 requests per 60 seconds
Legacy endpoint access via /api.php is also supported

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.render`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
UserID	Integer	Yes	User ID
ListID	Integer	Yes	List ID
SubscriberID	Integer	Yes	Subscriber ID
CampaignID	Integer	Yes	Campaign ID
AutoResponderID	Integer	Yes	AutoResponder ID
EmailID	Integer	Yes	Email ID
QueueRowID	Integer	Yes	Email Gateway queue row ID
IsPreview	Boolean	Yes	Preview mode flag (1 or 0)
DisablePersonalization	Boolean	Yes	Disable personalization (1 or 0)

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X GET "https://example.com/api/v1/email.render?UserID=100&ListID=50&SubscriberID=1000&CampaignID=200&EmailID=300&IsPreview=0&DisablePersonalization=0" \
  -H "Content-Type: application/json"

json

{
  "Subject": "Monthly Newsletter",
  "EmailContent": "<html><body>Personalized content...</body></html>"
}

json

{
  "Errors": [
    {
      "Code": 1,
      "Message": "Missing UserID parameter"
    }
  ]
}

txt

1: Missing UserID parameter
2: Missing ListID parameter
3: Missing SubscriberID parameter
4: Missing CampaignID parameter
5: Missing AutoResponderID parameter
6: Missing EmailID parameter
7: Missing QueueRowID parameter
8: Missing IsPreview parameter
9: Missing DisablePersonalization parameter
10: Invalid UserID parameter
11: Invalid ListID parameter
12: Invalid SubscriberID parameter
13: Invalid CampaignID parameter
14: Invalid AutoResponderID parameter
15: Invalid EmailID parameter
16: Invalid QueueRowID parameter

Render Email for SMTP Delivery

POST /api/v1/email.smtp.render

API Usage Notes

Authentication required: User API Key or Admin API Key
Rate limit: 10000 requests per 60 seconds
Legacy endpoint access via /api.php is also supported

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.smtp.render`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
UserID	Integer	No	User ID (auto-inferred from session or AdminAPIKey required)
CampaignID	Integer	No	Campaign ID (auto-infers EmailID and ListID)
AutoResponderID	Integer	No	AutoResponder ID (auto-infers EmailID and ListID)
EmailID	Integer	No	Email ID (auto-inferred from Campaign/AutoResponder)
ListID	Integer	No	List ID (auto-inferred from Campaign)
SubscriberID	Integer	No	Subscriber ID (random subscriber selected if not provided)
IsPreview	Boolean	No	Preview mode flag (accepts: 1/true/on/yes or 0/false/off/no)

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api/v1/email.smtp.render \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.smtp.render",
    "SessionID": "your-session-id",
    "CampaignID": 200
  }'

json

{
  "Subject": "Monthly Newsletter",
  "PreHeader": "Check out our latest updates",
  "HTMLBody": "<html><body>...</body></html>",
  "PlainBody": "Plain text version...",
  "SMTPHeaders": "From: sender@example.com\r\nTo: recipient@example.com\r\n...",
  "SMTPBody": "MIME encoded body with boundaries...",
  "EmailSizeBytes": 45678,
  "EmailSizeKB": 44.61,
  "EmailSizeMB": 0.04,
  "AttachmentCount": 2,
  "ContentType": "MultiPart",
  "HasHTMLContent": true,
  "HasPlainContent": true,
  "ImageEmbeddingEnabled": true,
  "FromEmail": "sender@example.com",
  "FromName": "Company Name",
  "ReplyToEmail": "reply@example.com",
  "ReplyToName": "Support Team",
  "MFROMDomain": "return.example.com",
  "TrackingDomain": "track.example.com"
}

json

{
  "Errors": [
    {
      "Code": 1,
      "Message": "Missing or invalid UserID parameter"
    }
  ]
}

txt

1: Missing or invalid UserID parameter
2: Invalid CampaignID parameter
3: Invalid AutoResponderID parameter
4: Missing or invalid EmailID parameter
5: Missing or invalid ListID parameter
6: Missing or invalid SubscriberID parameter

Get Personalization Tags

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.personalizationtags`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
Scope	Array	Yes	Tag scopes: `Subscriber`, `CampaignLinks`, `OptLinks`, `ListLinks`, `AllLinks`, `User`
ListID	Integer	Conditional	List ID (required if Scope contains `Subscriber`)

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.personalizationtags",
    "SessionID": "your-session-id",
    "Scope": ["Subscriber", "CampaignLinks", "User"],
    "ListID": 100
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "PersonalizationTags": [
    {
      "Tag": "%EmailAddress%",
      "Description": "Subscriber email address",
      "Category": "Subscriber"
    },
    {
      "Tag": "%Link:Unsubscribe%",
      "Description": "Unsubscribe link",
      "Category": "Links"
    }
  ]
}

json

{
  "Success": false,
  "ErrorCode": [1, 2]
}

txt

0: Success
1: Missing required parameter Scope
2: Missing required parameter ListID (when Subscriber scope is included)

Create Email Template

POST /api.php

API Usage Notes

Authentication required: User API Key or Admin API Key
Required permissions: EmailTemplates.Manage
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.template.create`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
TemplateName	String	Yes	Template name
TemplateDescription	String	No	Template description
TemplateSubject	String	No	Default subject line
TemplateHTMLContent	String	Conditional	HTML template content (at least one required)
TemplatePlainContent	String	Conditional	Plain text template content (at least one required)
TemplateThumbnailPath	String	No	Path to thumbnail image in tmp directory
RelOwnerUserID	Integer	No	Owner user ID (admin only)
AccessType	String	No	Access type setting

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.template.create",
    "SessionID": "your-session-id",
    "TemplateName": "Newsletter Template",
    "TemplateDescription": "Monthly newsletter design",
    "TemplateSubject": "Newsletter",
    "TemplateHTMLContent": "<html><body>Template content</body></html>"
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "TemplateID": 500
}

json

{
  "Success": false,
  "ErrorCode": [1, 2]
}

txt

0: Success
1: Missing required parameter TemplateName
2: At least one of TemplateHTMLContent or TemplatePlainContent must be provided

Get Email Template

POST /api.php

API Usage Notes

Authentication required: User API Key or Admin API Key
Required permissions: EmailTemplates.Manage
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.template.get`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
TemplateID	Integer	Yes	Template ID to retrieve

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.template.get",
    "SessionID": "your-session-id",
    "TemplateID": 500
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "Template": {
    "TemplateID": 500,
    "TemplateName": "Newsletter Template",
    "TemplateDescription": "Monthly newsletter design",
    "TemplateSubject": "Newsletter",
    "TemplateHTMLContent": "<html><body>Template content</body></html>",
    "TemplatePlainContent": "Template content",
    "RelOwnerUserID": 100
  }
}

json

{
  "Success": false,
  "ErrorCode": [1, 2, 3]
}

txt

0: Success
1: Missing required parameter TemplateID
2: Template not found
3: Access denied to template

Get Email Templates List

POST /api.php

API Usage Notes

Authentication required: User API Key or Admin API Key
Required permissions: EmailTemplates.Manage
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.templates.get`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.templates.get",
    "SessionID": "your-session-id"
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "TotalTemplateCount": 5,
  "Templates": [
    {
      "TemplateID": 500,
      "TemplateName": "Newsletter Template",
      "TemplateSubject": "Newsletter",
      "TemplateHTMLContent": "<html>...</html>",
      "TemplatePlainContent": "..."
    }
  ]
}

json

{
  "Success": false,
  "ErrorCode": []
}

txt

0: Success

Update Email Template

POST /api.php

API Usage Notes

Authentication required: User API Key or Admin API Key
Required permissions: EmailTemplates.Manage
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.template.update`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
TemplateID	Integer	Yes	Template ID to update
TemplateName	String	No	Template name
TemplateDescription	String	No	Template description
TemplateSubject	String	No	Default subject line
TemplateHTMLContent	String	No	HTML template content
TemplatePlainContent	String	No	Plain text template content
TemplateThumbnailPath	String	No	Path to thumbnail image in tmp directory
RelOwnerUserID	Integer	No	Owner user ID (admin only)
AccessType	String	No	Access type setting (admin only)

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.template.update",
    "SessionID": "your-session-id",
    "TemplateID": 500,
    "TemplateName": "Updated Newsletter Template",
    "TemplateHTMLContent": "<html><body>Updated content</body></html>"
  }'

json

{
  "Success": true,
  "ErrorCode": 0
}

json

{
  "Success": false,
  "ErrorCode": [1, 2]
}

txt

0: Success
1: Missing required parameter TemplateID
2: Template not found or access denied

Delete Email Template

POST /api.php

API Usage Notes

Authentication required: User API Key or Admin API Key
Required permissions: EmailTemplates.Manage
Not available in demo mode
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.template.delete`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
Templates	String	Yes	Comma-separated template IDs to delete (e.g., "500,501,502")

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.template.delete",
    "SessionID": "your-session-id",
    "Templates": "500,501,502"
  }'

json

{
  "Success": true,
  "ErrorCode": 0
}

json

{
  "Success": false,
  "ErrorCode": [1, 2]
}

txt

0: Success
1: Missing required parameter Templates
2: No templates found or access denied for deletion

Create Design Preview (Deprecated)

DEPRECATED POST /api.php

Deprecated Endpoint

This endpoint is deprecated with no replacement or alternative. It was used for PreviewMyEmail.com integration which is no longer supported.

API Usage Notes

Authentication required: User API Key
Required permissions: Email.DesignPreview
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.designpreview.create`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID to preview

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.designpreview.create",
    "SessionID": "your-session-id",
    "EmailID": 12345
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "JobID": 1000,
  "PreviewMyEmailJobID": "abc123"
}

json

{
  "Success": false,
  "ErrorCode": [1, 2, 3, 4, 5]
}

txt

0: Success
1: Missing required parameter EmailID
2: Email not found
3: Preview service connection error
4: Out of admin credits
5: Out of user credits

Delete Design Preview (Deprecated)

DEPRECATED POST /api.php

Deprecated Endpoint

This endpoint is deprecated with no replacement or alternative. It was used for PreviewMyEmail.com integration which is no longer supported.

API Usage Notes

Authentication required: User API Key
Required permissions: Email.DesignPreview
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.designpreview.delete`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID
JobID	Integer	Yes	Preview job ID

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.designpreview.delete",
    "SessionID": "your-session-id",
    "EmailID": 12345,
    "JobID": 1000
  }'

json

{
  "Success": true,
  "ErrorCode": 0
}

json

{
  "Success": false,
  "ErrorCode": [1, 2, 3, 4, 5]
}

txt

0: Success
1: Missing required parameter EmailID
2: Missing required parameter JobID
3: Email not found
4: Preview job not found
5: Preview service connection error

Get Design Preview Details (Deprecated)

DEPRECATED POST /api.php

Deprecated Endpoint

This endpoint is deprecated with no replacement or alternative. It was used for PreviewMyEmail.com integration which is no longer supported.

API Usage Notes

Authentication required: User API Key
Required permissions: Email.DesignPreview
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.designpreview.details`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID
JobID	Integer	Yes	Preview job ID

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.designpreview.details",
    "SessionID": "your-session-id",
    "EmailID": 12345,
    "JobID": 1000
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "PreviewRequest": {
    "JobID": 1000,
    "PreviewMyEmailJobID": "abc123",
    "Status": "Complete",
    "PreviewResults": [
      {
        "ClientCode": "outlook2019",
        "ImagesOnURL": "https://...",
        "ImagesOffURL": "https://...",
        "ThumbnailURL": "https://..."
      }
    ]
  }
}

json

{
  "Success": false,
  "ErrorCode": [1, 2, 3, 4, 5]
}

txt

0: Success
1: Missing required parameter EmailID
2: Email not found
3: Missing required parameter JobID
4: Preview job not found
5: Preview service connection error

Get Design Preview List (Deprecated)

DEPRECATED POST /api.php

Deprecated Endpoint

This endpoint is deprecated with no replacement or alternative. It was used for PreviewMyEmail.com integration which is no longer supported.

API Usage Notes

Authentication required: User API Key
Required permissions: Email.DesignPreview
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.designpreview.getlist`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
EmailID	Integer	Yes	Email ID

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.designpreview.getlist",
    "SessionID": "your-session-id",
    "EmailID": 12345
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "PreviewList": [
    {
      "JobID": 1000,
      "PreviewMyEmailJobID": "abc123",
      "Status": "Complete",
      "SubmitDate": "2024-01-15 10:30:00"
    }
  ]
}

json

{
  "Success": false,
  "ErrorCode": [1, 2]
}

txt

0: Success
1: Missing required parameter EmailID
2: Email not found

Delete Attachment

POST /api.php

API Usage Notes

Authentication required: User API Key
Legacy endpoint access via /api.php only (no v1 REST alias configured)

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `attachment.delete`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
AttachmentID	Integer	Yes	Attachment ID to delete

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "attachment.delete",
    "SessionID": "your-session-id",
    "AttachmentID": 789
  }'

json

{
  "Success": true,
  "ErrorCode": 0,
  "ErrorText": ""
}

json

{
  "Success": false,
  "ErrorCode": [1]
}

txt

0: Success
1: Missing required parameter AttachmentID

Convert HTML to Plain Text

POST /api/v1/email.html2text

API Usage Notes

Authentication required: User API Key
Rate limit: 1000 requests per 60 seconds
Legacy endpoint access via /api.php is also supported

Stateless utility endpoint that converts an HTML email body into its plain-text equivalent. Useful when generating the PlainContent variant of a campaign email programmatically — e.g., during automated campaign creation or before sending through email.render.

Internally calls the same Soundasleep\Html2Text library used by the campaign-create UI's "Generate plain text from HTML" button, the email model's auto-conversion (when PlainContentAutoConvert is enabled), and the queue worker. Conversion options are hard-coded to match the UI verbatim (ignore_errors=true, drop_links=false), so the output is byte-for-byte identical to what users see in the in-app editor.

Behavior details:

Link URLs are preserved inline (e.g. <a href="https://example.com">Click</a> becomes Click [https://example.com]).
Merge tags such as [SUBSCRIBER_FIRSTNAME] are preserved verbatim — the library only strips HTML markup, and merge tags live in text nodes.
Malformed HTML is tolerated; the library returns partial output rather than throwing.
An empty HTMLContent value returns an empty PlainContent.
Character encoding is auto-detected via mb_detect_encoding; UTF-8 is handled safely.
The endpoint performs no database access and has no per-user resource ownership — it is purely a stateless transform of the request payload.

Request Body Parameters:

Parameter	Type	Required	Description
Command	String	Yes	API command: `email.html2text`
SessionID	String	No	Session ID obtained from login
APIKey	String	No	API key for authentication
HTMLContent	String	Yes	The HTML to convert. Empty string is allowed and returns an empty `PlainContent`.

Example RequestSuccess ResponseError ResponseError Codes

bash

curl -X POST https://example.com/api/v1/email.html2text \
  -H "Content-Type: application/json" \
  -d '{
    "Command": "email.html2text",
    "APIKey": "your-api-key",
    "HTMLContent": "<h1>Hello</h1><p>Visit <a href=\"https://example.com\">our site</a> for details.</p>"
  }'

json

{
  "Success": true,
  "PlainContent": "HELLO\n\nVisit our site [https://example.com] for details."
}

json

{
  "Errors": [
    {
      "Code": 1,
      "Message": "Missing HTMLContent parameter"
    }
  ]
}

txt

1: Missing HTMLContent parameter (returned with HTTP 422)
2: HTML conversion failed (returned with HTTP 500 — defensive catch for the rare case the library throws despite ignore_errors=true)

Email API Documentation ​

Create an Email ​

Get Email Details ​

Get Emails (List or Bulk by IDs) ​

Update an Email ​

Delete an Email ​

Duplicate an Email ​

Send Email Preview ​

Test Email Delivery Settings ​

Test Email Against Spam Filters ​

Render Email in Browser ​

Render Email for SMTP Delivery ​

Get Personalization Tags ​

Create Email Template ​

Get Email Template ​

Get Email Templates List ​

Update Email Template ​

Delete Email Template ​

Create Design Preview (Deprecated) ​

Delete Design Preview (Deprecated) ​

Get Design Preview Details (Deprecated) ​

Get Design Preview List (Deprecated) ​

Delete Attachment ​

Convert HTML to Plain Text ​

Email API Documentation

Create an Email

Get Email Details

Get Emails (List or Bulk by IDs)

Update an Email

Delete an Email

Duplicate an Email

Send Email Preview

Test Email Delivery Settings

Test Email Against Spam Filters

Render Email in Browser

Render Email for SMTP Delivery

Get Personalization Tags

Create Email Template

Get Email Template

Get Email Templates List

Update Email Template

Delete Email Template

Create Design Preview (Deprecated)

Delete Design Preview (Deprecated)

Get Design Preview Details (Deprecated)

Get Design Preview List (Deprecated)

Delete Attachment

Convert HTML to Plain Text