Create a draft from a template

POST

/api/v3/letters/{letterUuid}/actions/draft

Create a draft from a template

Authorizations

• bearerAuth

Parameters

Path Parameters

letterUuid

required

string

Request Body

Media type application/json

object

api

boolean

channel

string

curations

Array<object>

object

excerpt

string

tags

Array<string>

title

string

url

string

subject

string

Examples

Example Create a draft from a template

{
  "api": true,
  "channel": "an-example-channel",
  "curations": [
    {
      "excerpt": "Pan's Labyrinth should be number one, we think.",
      "tags": [
        "pans-labyrinth"
      ],
      "title": "The 100 Best Movies of the 21st Century",
      "url": "https://www.nytimes.com/interactive/2025/movies/best-movies-21st-century.html"
    }
  ],
  "subject": "Who doesn't love a good movie?"
}

Responses

201

Create a draft from a template

Media type text/plain

Examples

Example Create a draft from a template

{
    "items": {
        "createdAt": "2026-04-01 13:20:51",
        "emailTemplate": "<!-->Your letter's HTML will be here.<!-->",
        "insights": {
            "readability": {
                "ease": 7,
                "seconds": 13,
                "time": "1 minute read"
            },
            "size": 7,
            "wordCount": 45
        },
        "publicationDate": "",
        "publicationDateOffset": "-08:00",
        "publicationDateTzCode": "America/Los_Angeles",
        "publicationStatus": 7,
        "private": true,
        "segmentId": segmentIdentifierWillBeHere,
        "subtitle": "",
        "title": "Who doesn't love a good movie?",
        "updatedAt": "2026-04-24 13:20:51",
        "uniqueId": "l8300dks7r",
        "useComposer": true
    },
    "message": "Edition created from template huzag99ltz.",
    "total": 1
}

Headers

:status

string

Example

201

access-control-allow-credentials

string

Example

true

access-control-allow-origin

string

Example

*

access-control-max-age

string

Example

86400

alt-svc

string

Example

h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

cache-control

string

Example

no-cache, private

date

string

Example

Fri, 24 Apr 2026 13:20:52 GMT

server

string

Example

nginx/1.27.3

via

string

Example

1.1 google

x-powered-by

string

Example

PHP/7.4.33