Skip to main content
POST
/
v1
/
transactional-emails
/
{transactionalId}
/
publish
Publish a transactional email
curl --request POST \
  --url https://app.loops.so/api/v1/transactional-emails/{transactionalId}/publish \
  --header 'Authorization: Bearer <token>'
{
  "id": "cmnx1d95z001llilji4vapgqs",
  "name": "Welcome email",
  "draftEmailMessageId": null,
  "publishedEmailMessageId": "cmn5bia4i0217tzli8ric8giv",
  "createdAt": "2026-03-28T15:00:00.000Z",
  "updatedAt": "2026-03-28T15:30:00.000Z",
  "dataVariables": [
    "firstName",
    "lastName"
  ]
}
Content API endpoints are currently in an open alpha and are subject to change.
The transactional email’s current draft email message is published. The draft becomes the published version and the draft is cleared. After publishing, use the returned id as transactionalId with Send a transactional email to send the email.

​
Request

​
Path parameters

​
transactionalId
string
required
The ID of the transactional email.

​
Body

No request body.

​
Response

​
Success

​
id
string
required
The transactional email ID.
​
name
string
required
The transactional email’s name.
​
draftEmailMessageId
nullable string
required
The ID of the draft email message. This is null after a successful publish.
​
publishedEmailMessageId
nullable string
required
The ID of the published email message.
​
createdAt
string
required
ISO 8601 timestamp for when the transactional email was created.
​
updatedAt
string
required
ISO 8601 timestamp for when the transactional email was last updated.
​
dataVariables
array
required
Data variable names used by the published email. Empty for unpublished transactionals.

​
Error

If transactionalId is invalid, a 400 Bad Request is returned. A 404 Not Found is returned if the transactional email does not exist. A 409 Conflict is returned if there is no draft to publish. A 422 Unprocessable Entity is returned if the draft failed validation, the sending domain is not verified, or content was flagged as unsafe. If the API key is invalid (or content API is not enabled for your team), a 401 Unauthorized is returned.
​
message
string
required
An error message describing what went wrong.
{
  "id": "cmnx1d95z001llilji4vapgqs",
  "name": "Welcome email",
  "draftEmailMessageId": null,
  "publishedEmailMessageId": "cmn5bia4i0217tzli8ric8giv",
  "createdAt": "2026-03-28T15:00:00.000Z",
  "updatedAt": "2026-03-28T15:30:00.000Z",
  "dataVariables": [
    "firstName",
    "lastName"
  ]
}
Last modified on June 8, 2026