Email blocks and designs

Toolset email_library, 9 tools.

RecordsCopy Anchor Link

email_saved_blockCopy Anchor Link

A block the merchant saved for reuse in store emails, newsletters and automations: a content block, or a header or footer that can follow the store style.

• Permission: content.read
• Tools: email_saved_block_list, email_saved_block_get

Filters on the list:

ActionsCopy Anchor Link

email_defaults_restoreCopy Anchor Link

Add the starter's emails and texts the theme draft lacks; emails it already has stay as they are.

• Action key: email_defaults.restore
• Permission: theme.write
• Approval: Waits for approval when the store requires it for this action.
• Effect: Changes a draft; nothing goes live until it is published.
• Retries: runs at most once; a repeat with the same idempotency key returns the first result.

Example input:

{}

email_new_design_getCopy Anchor Link

What taking the starter's new design would make of an email: its document and texts per language, and whether the merchant's own subject and preheader stay.

Answers not found when the theme offers no new design for this email; email_case_list and the theme tell which emails have one.

• Action key: email_new_design.get
• Permission: theme.read
• Approval: Runs without approval.
• Effect: Reads only.
• Retries: safe to repeat with the same input.

Example input:

{
  "slug": "order-placed"
}

email_new_design_keepCopy Anchor Link

Keep an email as it is and stop offering the starter's new design until the starter changes it again.

• Action key: email_new_design.keep
• Permission: theme.write
• Approval: Waits for approval when the store requires it for this action.
• Effect: Changes a draft; nothing goes live until it is published.
• Retries: runs at most once; a repeat with the same idempotency key returns the first result.

Example input:

{
  "slug": "order-placed"
}

email_new_design_takeCopy Anchor Link

Replace an email in the draft with the starter's new design, keeping the merchant's own subject and preheader.

• Action key: email_new_design.take
• Permission: theme.write
• Approval: Always waits for a person to approve it.
• Effect: Changes a draft; nothing goes live until it is published.
• Destructive: in compact mode it runs with run_destructive_action.
• Retries: runs at most once; a repeat with the same idempotency key returns the first result.

Example input:

{
  "slug": "order-placed"
}

email_saved_block_createCopy Anchor Link

Save a block for reuse in store emails, newsletters and automations.

• Action key: email_saved_block.create
• Permission: content.write
• Approval: Waits for approval when the store requires it for this action.
• Effect: Changes the live store.
• Retries: runs at most once; a repeat with the same idempotency key returns the first result.

Example input:

{
  "name": "Holiday hours",
  "block": {
    "id": "text-1",
    "type": "text",
    "text_key": "holiday"
  },
  "copy": {
    "en": {
      "holiday": "We are closed on 24–26 December."
    }
  }
}

email_saved_block_deleteCopy Anchor Link

Delete a saved email block; emails that placed a copy of it keep their copy.

• Action key: email_saved_block.delete
• Permission: content.write
• Approval: Always waits for a person to approve it.
• Effect: Changes the live store.
• Destructive: in compact mode it runs with run_destructive_action.
• Retries: runs at most once; a repeat with the same idempotency key returns the first result.

Example input:

{
  "id": "019bb28a-18ac-7ff7-a492-89866e738126"
}

email_saved_block_updateCopy Anchor Link

Rename a saved email block or replace its block, texts or kind.

• Action key: email_saved_block.update
• Permission: content.write
• Approval: Waits for approval when the store requires it for this action.
• Effect: Changes the live store.
• Retries: runs at most once; a repeat with the same idempotency key returns the first result.

Example input:

{
  "id": "019bb28a-18ac-7ff7-a492-89866e738126",
  "name": "Holiday hours 2026"
}