SmartMatchApp

Update Email Draft

Revise a draft's copy in place — subject, message, and/or campaign_id. Only the keys present in the request body are changed; recipients are intentionally not editable through the API (a human owns the audience).

Example Request:
curl "https://<your-agency>.smartmatchapp.com/api3/email/drafts/<draft_id>/" \
    -u <token>: \
    -X PUT \
    -d "subject=Product update — August (revised)"
Request Parameters:

subject: (Optional) New subject line.

message: (Optional) New HTML body, sanitized on the same path as the CRM compose modal.

campaign_id: (Optional) Must belong to the same agency.

Example Success Response:
HTTP 204 No Content
Base Request:

Method: PUT

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

Rate Limits:

10 requests within 10 seconds

Error Responses:
400 Bad Request

This error occurs if campaign_id is invalid or from another agency.
Possible errors: "select a valid choice"
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"
404 Not Found

This error occurs if the draft with the specified ID does not exist or is not visible to the token user.
Possible errors: "object does not exist"
405 Method Not Allowed

This error occurs if an HTTP method other than PUT 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"