Skip to content

Publish Email Content

Tool name: publish-newsletter-email-content

Publishes the drag-and-drop editor draft of one KlickTipp email newsletter: from then on that body is what a dispatch sends, replacing the previously published one. This changes what real recipients would receive and has no undo. It takes no HTML -- only the stored draft is published -- and is bound to the content revision of the preceding read or write; if the newsletter changed in between, nothing is published. Only a draft can be published, and a body using editor features the server must not publish on a person's behalf is refused with the editor URL. Sending is separate: prepare-newsletter-dispatch. Returns content status before and after, the new revision and the editor URL.

Input schema

editorUrlstring, [ 12 .. 500 ] charactersrequired

Editor URL of the email, exactly as returned by get-email-editor-content

contentRevisionstring, [ 7 .. 100 ] charactersrequired

contentRevision of the state to publish, from the read or the last write; a stale one refuses

accountIdnull or integer, >= 1

User ID of the account; omit for the account the access token works in

Default:null
Input example
{ "editorUrl": "stringstring", "contentRevision": "strings", "accountId": null }

Output schema

One of:
operationstringrequired

"unchanged": the draft already was the dispatch content; nothing was written.

Enum:"published""unchanged"
previousContentStatusstringrequired
Enum:"draft""published""unpublished_changes"
contentStatusstringrequired
Value:"published"
emailIdintegerrequired
contentRevisionstringrequired
warningsArray of stringsrequired
editorUrlstringrequired
Output example
{ "operation": "published", "previousContentStatus": "draft", "contentStatus": "published", "emailId": 0, "contentRevision": "string", "warnings": [ "string" ], "editorUrl": "string" }