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. When 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`. Only senders with `verified` status can be used as the sender on an envelope.
{
"$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"
]
}
}
}
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.