# Replace Email Signature Content

Replaces an email signature’s HTML and plain content in full, without MCP undo. HTML requires %%Link:Unsubscribe%% as the href of a link and %%User:FirstName%%, %%User:LastName%%, %%User:Street%%, %%User:Zip%%, %%User:City%% and %%User:Country%% (permitted address omissions excepted). Plain text needs the same but may show unsubscribe as text; it is stored only when plain-content editing is allowed, otherwise regenerated from HTML. Transactional fields change only when supplied; transactional content needs address fields and no unsubscribe link, %%Link:SubscriberInfo%% is recommended. useInTransactionalEmails false with an empty transactionalHtml disables and clears it. Returns content flags only; use get-signature with includeContent true. Metadata, tags and sender stay unchanged.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "signatureId": {
      "type": "integer",
      "description": "ID of the signature whose normal content is replaced and whose transactional content may be changed",
      "minimum": 1
    },
    "html": {
      "type": "string",
      "description": "Complete HTML signature content",
      "minLength": 1,
      "maxLength": 65536
    },
    "plain": {
      "type": [
        "null",
        "string"
      ],
      "description": "Complete plain content; stored trimmed only when plain-content editing is enabled, otherwise regenerated from HTML",
      "default": null,
      "maxLength": 65536
    },
    "useInTransactionalEmails": {
      "type": [
        "null",
        "boolean"
      ],
      "description": "Whether the signature is used in transactional emails; omit to keep the current setting",
      "default": null
    },
    "transactionalHtml": {
      "type": [
        "null",
        "string"
      ],
      "description": "Complete transactional HTML content; omit to keep it, or pass an empty string with useInTransactionalEmails false to clear it",
      "default": null,
      "maxLength": 65536
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account that owns the signature; omit for the token account, or pass an accessible subaccount ID",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "signatureId",
    "html"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "signatureId",
    "name",
    "isDefault",
    "notes",
    "metaLabels",
    "tagIds",
    "isUsable",
    "blockers",
    "senderProfile",
    "vCard",
    "content",
    "editUrl"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "signatureId": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "isDefault": {
      "type": "boolean"
    },
    "notes": {
      "type": "string"
    },
    "metaLabels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tagIds": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "isUsable": {
      "type": "boolean"
    },
    "blockers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "senderProfile": {
      "type": "object",
      "required": [
        "senderName",
        "senderEmail",
        "replyToEmail",
        "ccEmail",
        "bccEmail",
        "toEmail",
        "senderDomain",
        "senderAddressStatus",
        "senderAddressIsUsable",
        "senderAddressExplanation",
        "senderIdentity"
      ],
      "properties": {
        "senderName": {
          "type": "string"
        },
        "senderEmail": {
          "type": "string"
        },
        "replyToEmail": {
          "type": "string"
        },
        "ccEmail": {
          "type": "string"
        },
        "bccEmail": {
          "type": "string"
        },
        "toEmail": {
          "type": "string"
        },
        "senderDomain": {
          "type": "string"
        },
        "senderAddressStatus": {
          "type": "string",
          "enum": [
            "",
            "dkim-valid",
            "not-confirmed",
            "no-domain",
            "dkim-invalid",
            "not-configured"
          ]
        },
        "senderAddressIsUsable": {
          "type": "boolean"
        },
        "senderAddressExplanation": {
          "type": "string"
        },
        "senderIdentity": {
          "type": "object",
          "required": [
            "effectiveSenderEmail",
            "customerDomain",
            "normalizedSenderDomain",
            "status",
            "isUsable",
            "senderEmailOptions",
            "senderDomainOptions"
          ],
          "properties": {
            "effectiveSenderEmail": {
              "type": [
                "string",
                "null"
              ]
            },
            "customerDomain": {
              "type": [
                "string",
                "null"
              ]
            },
            "normalizedSenderDomain": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "ready",
                "address-not-configured",
                "address-not-confirmed",
                "address-not-usable",
                "address-blocked",
                "domain-not-configured",
                "domain-not-verified",
                "domain-not-yet-usable",
                "domain-mismatch",
                null
              ]
            },
            "isUsable": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "senderEmailOptions": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "senderDomainOptions": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "vCard": {
      "type": "object",
      "required": [
        "hasData",
        "firstName",
        "lastName",
        "companyName",
        "emailAddress",
        "phone",
        "cellPhone",
        "street",
        "zip",
        "city",
        "state",
        "country",
        "website"
      ],
      "properties": {
        "hasData": {
          "type": "boolean"
        },
        "firstName": {
          "type": "string"
        },
        "lastName": {
          "type": "string"
        },
        "companyName": {
          "type": "string"
        },
        "emailAddress": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "cellPhone": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "website": {
          "type": "string"
        }
      }
    },
    "content": {
      "type": "object",
      "required": [
        "hasHtml",
        "hasPlain",
        "hasTransactionalHtml",
        "useInTransactionalEmails",
        "html",
        "plain",
        "transactionalHtml"
      ],
      "properties": {
        "hasHtml": {
          "type": "boolean"
        },
        "hasPlain": {
          "type": "boolean"
        },
        "hasTransactionalHtml": {
          "type": "boolean"
        },
        "useInTransactionalEmails": {
          "type": "boolean"
        },
        "html": {
          "type": [
            "string",
            "null"
          ]
        },
        "plain": {
          "type": [
            "string",
            "null"
          ]
        },
        "transactionalHtml": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "editUrl": {
      "type": "string"
    }
  }
}
```