SmartMatchApp

List Email Drafts

Retrieve the agency's email drafts. Returns all agency-scoped drafts plus the token user's own personal drafts — other users' personal drafts are never listed.

Example Request:
curl "https://<your-agency>.smartmatchapp.com/api3/email/drafts/" \
    -u <token>: \
    -X GET
Example Success Response:
{
    "objects": [
        {
            "id": 12,
            "subject": "Product update — August",
            "message": "<p>Here is what shipped this month.</p>",
            "cc": "",
            "bcc": "",
            "scope": "agency",
            "recipient_single_ids": [],
            "recipient_emails": [],
            "campaign_id": null,
            "template_id": null,
            "created_by_agency_user_id": 3,
            "created": "2026-08-16T14:30:00+00:00",
            "modified": "2026-08-16T14:30:00+00:00"
        }
    ],
    "count": 20,
    "offset": 0,
    "total_count": 1
}

message may contain HTML. Use the count and offset query parameters to paginate.

Base Request:

Method: GET

Authentication: Basic Authentication. Requires a valid <token> passed.

Rate Limits:

30 requests within 10 seconds

Error Responses:
401 Unauthorized

This error occurs when the <token> is missing, invalid, or the API access is disabled.

Possible errors: "not authenticated" or "token is disabled" or "Agency API is disabled"
405 Method Not Allowed

This error occurs if an HTTP method other than GET is used.
Possible errors: "wrong method"
429 Too Many Requests

This error occurs when the client has sent too many requests in a given amount of time, leading to rate limiting by the server.

Possible errors: "too many requests"
500 Server Error

Possible errors: "Internal server error"