# Configure Email Signature Delivery

Configures an email signature’s assigned tags and sender, reply, CC, BCC, recipient or domain. Omitted fields stay. Tag IDs must exist and be unassigned to another signature; a changed sender needs a verified domain; the sender domain is derived and stored when omitted. Content and business card stay unchanged.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "signatureId": {
      "type": "integer",
      "description": "ID of the signature whose delivery configuration is changed",
      "minimum": 1
    },
    "tagIds": {
      "type": [
        "array",
        "null"
      ],
      "description": "Replacement tag IDs that already exist; ordinary signatures require at least one, and every tag must be unassigned to another signature, while the default signature may use an empty array",
      "default": null,
      "items": {
        "type": "integer",
        "minimum": 1
      },
      "maxItems": 50
    },
    "senderProfile": {
      "type": "object",
      "description": "Sender name and configured account address/domain values; reply options are also used for CC, BCC and recipient, empty strings clear optional fields, omitted fields stay unchanged, and the sender domain is derived when the sender address changes",
      "default": null,
      "properties": {
        "senderName": {
          "type": "string",
          "maxLength": 250
        },
        "senderEmail": {
          "type": "string",
          "maxLength": 250
        },
        "replyToEmail": {
          "type": "string",
          "maxLength": 250
        },
        "ccEmail": {
          "type": "string",
          "maxLength": 250
        },
        "bccEmail": {
          "type": "string",
          "maxLength": 250
        },
        "toEmail": {
          "type": "string",
          "maxLength": 250
        },
        "senderDomain": {
          "type": "string",
          "maxLength": 250
        }
      },
      "additionalProperties": false
    },
    "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"
  ],
  "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"
    }
  }
}
```