Skip to main content
A sender is a verified email address. SignatureAPI sends signing request emails to recipients on behalf of the sender’s address. The sender’s name, email address, and organization appear in every email sent to recipients, and the sender’s address is used as the Reply-To address. Before an email address can be used as a sender, the address owner must complete email verification. SignatureAPI initiates this by sending a verification email when you create the sender.

​
Verification lifecycle

When you create a sender, it starts in pending_verification status. SignatureAPI sends a verification email to the address. Once the address owner clicks the confirmation link, the status changes to verified. If the verification email bounces or an error occurs, the status changes to failed. Only senders with verified status can be assigned to envelopes.

​
Managing senders

You can manage senders in the Dashboard under Settings, or programmatically using the API.
Sender management via API is currently in public preview. To enable it, contact support.
Dashboard. When you created your SignatureAPI account, a sender was automatically added using your account email address. That sender is already verified. To add a new sender, click New Sender in the Senders settings and enter the email address to verify. API. Create a sender using the Create a sender endpoint. SignatureAPI sends the verification email automatically. Listen for the sender.verified or sender.failed webhook events to track the outcome.

​
Default sender

Every account has a default sender. When you create an envelope without specifying a sender, SignatureAPI uses the default sender’s name and email. To change your account’s default sender, click Set default next to the desired sender in the Dashboard. To specify a sender explicitly on an envelope, include the sender property in the request body: 
// POST https://api.signatureapi.com/v1/envelopes
// X-API-Key: key_test_...
// Content-Type: application/json

{
    "title": "Consulting Agreement",
    //...
    "sender": {
        "name": "Jennifer Lee",
        "email": "jennifer@example.com",
        "organization": "Acme Enterprises"
    }
}

​
Attributes

​
id
string
required
The unique identifier of the sender.
​
email
string
required
The email address of the sender. SignatureAPI sends signing request emails to recipients on behalf of this address.
​
status
enum
required
The current verification status of the sender.
  • pending_verification - A verification email was sent. The address owner has not yet confirmed.
  • verified - The address owner confirmed the verification email. This sender can be used on envelopes.
  • failed - Verification failed due to a bounce or error. This sender cannot be used.
​
created_at
string
required
The time at which the sender was created, formatted as an timestamp.
{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "email": "jennifer@example.com",
    "status": "verified",
    "created_at": "2025-01-01T00:00:00.000Z"
}