# Create Sender Address

Registers a sender address and sends a real confirmation email to it; only the recipient can confirm it via the link. Cannot confirm, replace or delete addresses. Normal sending also needs a verified customer domain. Validation failures are returned separately with codes and reasons.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Address to register; its owner receives a confirmation email and must click the link themselves",
      "minLength": 1,
      "maxLength": 250
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account of the access token",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "created",
    "address",
    "rejections"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "created": {
      "type": "boolean"
    },
    "address": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "email",
            "displayEmail",
            "isAccountAddress",
            "isConfirmed",
            "isUsableForSending",
            "status",
            "statusExplanation",
            "senderDomain",
            "domainUsableForSending",
            "settingsUrl"
          ],
          "properties": {
            "email": {
              "type": "string"
            },
            "displayEmail": {
              "type": "string"
            },
            "isAccountAddress": {
              "type": "boolean"
            },
            "isConfirmed": {
              "type": "boolean"
            },
            "isUsableForSending": {
              "type": "boolean"
            },
            "status": {
              "type": "string",
              "enum": [
                "dkim-valid",
                "dkim-invalid",
                "not-confirmed",
                "not-configured",
                "no-domain",
                "domain-not-verified"
              ]
            },
            "statusExplanation": {
              "type": "string"
            },
            "senderDomain": {
              "type": [
                "string",
                "null"
              ]
            },
            "domainUsableForSending": {
              "type": "boolean"
            },
            "settingsUrl": {
              "type": "string"
            }
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "rejections": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "code",
          "reason"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```