Sender

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/sendgrid/main/json-schema/sendgrid-sender-schema.json",
  "title": "Sender",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/sendgrid-senders-api-openapi.yml#/components/schemas/Sender",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "The unique identifier of the Sender."
    },
    "nickname": {
      "type": "string",
      "description": "A nickname for the Sender. Not used for sending."
    },
    "from": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string",
          "description": "The email address from which your recipient will receive emails."
        },
        "name": {
          "type": "string",
          "description": "The name appended to the from email field. Typically your name or company name."
        }
      },
      "required": [
        "email",
        "name"
      ]
    },
    "reply_to": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string",
          "description": "The email address to which your recipient will reply."
        },
        "name": {
          "type": "string",
          "description": "The name appended to the reply to email field. Typically your name or company name."
        }
      },
      "required": [
        "email"
      ]
    },
    "address": {
      "type": "string",
      "description": "The physical address of the Sender."
    },
    "address_2": {
      "type": "string",
      "description": "Additional Sender address information."
    },
    "city": {
      "type": "string",
      "description": "The city of the Sender."
    },
    "state": {
      "type": "string",
      "description": "The state of the Sender."
    },
    "zip": {
      "type": "string",
      "description": "The zipcode of the Sender."
    },
    "country": {
      "type": "string",
      "description": "The country of the Sender."
    },
    "verified": {
      "type": "boolean",
      "description": "A boolean flag indicating whether the Sender is verified or not. Only verified Senders can be used to send email."
    },
    "locked": {
      "type": "boolean",
      "description": "A boolean flag that is `true` when the Sender is associated with a campaign in Draft, Scheduled, or In Progress status. You cannot update or delete a locked Sender."
    },
    "updated_at": {
      "type": "integer",
      "description": "The time the Sender was last updated."
    },
    "created_at": {
      "type": "integer",
      "description": "The time the Sender was created."
    }
  },
  "required": [
    "address",
    "city",
    "country",
    "created_at",
    "from",
    "id",
    "locked",
    "nickname",
    "reply_to",
    "updated_at",
    "verified"
  ]
}