stensul-copy-email

Creates an independent draft copy of an email, keeping all content, modules and layout. The original is never changed.

write: changes contentScope emails:write

Copying into a different library needs the duplicate_email_between_libraries permission. If the copy also needs new content, stensul-build-email with copy_of does both in one call.

Inputs

emailIdstring (24-char hex id)required
ID of the email to copy.
namestringrequired
Name for the copy.
library_keystringoptional
Destination library (defaults to the source library).
languagestringoptional
Language code for the copy.
subject_linestringoptional
Subject line for the copy.
preheaderstringoptional
Preheader for the copy.
titlestringoptional
Title for the copy.
tagsstring[]optional
Tags for the copy.
project_idstringoptional
Project for the copy.
typestringoptional
Email type for the copy.

Errors people hit

What you see	Fix
401 Authentication expired or missing The session's authorization expired.	Sign in again when the host prompts. On a 401 or 403, the server's instructions tell the model to re-check sign-in first.
403 Insufficient OAuth scope (403): The token lacks the required scope The API connection doesn't have the scope this tool needs.	An admin adds the scope to the API connection. Then sign in again: adding a scope revokes existing tokens.
403 API error (403): Action is unauthorized. The signed-in user's role lacks the permission, for example `edit_campaign`.	Grant the permission to the user's role in Admin > Users & Roles. It works for other users on the same connection.

All errors: Errors and troubleshooting.

{
  "emailId": "64f0c0ffee0000000000abcd",
  "name": "Northwind – Autumn launch (DE)",
  "language": "de-DE"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "stensul-copy-email",
    "arguments": {
      "emailId": "64f0c0ffee0000000000abcd",
      "name": "Northwind – Autumn launch (DE)",
      "language": "de-DE"
    }
  }
}

Response

The new draft with an embedded preview. created_by may show as System; that is expected.

Described from the tool's definition. Captured responses from a Stensul-internal tenant will replace this.

Example values use invented brands and ids. Tool list captured 2026-09-28.