Operations

Create a sender

POST

/ v1 / senders

Sender management via API is currently in public preview. To enable it, contact support.

Registers a new sender email address and starts the verification process. SignatureAPI sends a verification email to the provided address. The sender is returned with pending_verification status.

Once the address owner clicks the confirmation link, the sender status changes to verified. The sender can then be used on envelopes. Listen for the sender.verified or sender.failed webhook events to track the outcome.

Body parameters

string

required

The email address to register as a sender. Must be a valid email address. Maximum 320 characters.

Returns

Returns a 201 Created status code and a sender object on success, or an error otherwise.

// POST https://api.signatureapi.com/v1/senders
// X-API-Key: key_test_...
// Content-Type: application/json

{
    "email": "jennifer@example.com"
}

// HTTP/1.1 201 Created

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "email": "jennifer@example.com",
    "status": "pending_verification",
    "created_at": "2025-01-01T00:00:00.000Z"
}