{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/signatureapi-com/json-schema/signatureapi-com-sender-sender-schema.json",
  "title": "Sender",
  "description": "A **sender** is a verified email address that SignatureAPI sends signing requests on behalf of. Each sender must complete email verification before it can be used with envelopes.\n\nWhen you create a sender, SignatureAPI sends a verification email to the provided address. The sender starts in `pending_verification` status. Once the email owner clicks the confirmation link, the status changes to `verified`. If the verification email bounces or encounters an error, the status changes to `failed`.\n\nOnly senders with `verified` status can be used as the sender on an envelope.\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/signatureapi-com-senders-api-openapi.yml#/components/schemas/Sender.Sender",
  "x-schema-role": "model",
  "x-schema-direction": "output",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "id": {
      "$ref": "#/$defs/Sender.Id"
    },
    "email": {
      "$ref": "#/$defs/Sender.Email"
    },
    "status": {
      "$ref": "#/$defs/Sender.Status"
    },
    "created_at": {
      "$ref": "#/$defs/Sender.CreatedAt"
    }
  },
  "required": [
    "id",
    "email",
    "status",
    "created_at"
  ],
  "$defs": {
    "Sender.CreatedAt": {
      "x-schema-role": "property",
      "x-schema-direction": "output",
      "type": "string",
      "format": "date-time",
      "title": "Sender Created At",
      "description": "Time at which the sender was created. Formatted as an ISO 8601 timestamp."
    },
    "Sender.Email": {
      "x-schema-role": "property",
      "x-schema-direction": "any",
      "title": "Sender Email",
      "description": "The email address of the sender. SignatureAPI sends signing request emails to recipients on behalf of this address.",
      "type": "string",
      "format": "email",
      "maxLength": 320
    },
    "Sender.Id": {
      "x-schema-role": "property",
      "x-schema-direction": "output",
      "type": "string",
      "title": "Sender ID",
      "description": "The unique identifier of the sender."
    },
    "Sender.Status": {
      "x-schema-role": "property",
      "x-schema-direction": "output",
      "title": "Sender Status",
      "description": "The current verification status of the sender.\n\n- `pending_verification` — A verification email has been sent but the sender has not yet confirmed.\n- `verified` — The sender confirmed the verification email and can be used to send envelopes.\n- `failed` — The verification email bounced or encountered an error. This sender cannot be used.\n",
      "type": "string",
      "enum": [
        "pending_verification",
        "verified",
        "failed"
      ]
    }
  }
}