> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a sender

> Register a new sender email address and start the verification process

<Note>Sender management via API is currently in public preview. To enable it, contact [support](https://signatureapi.com/support).</Note>

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`](/docs/api/resources/events/sender-events#sender.verified) or [`sender.failed`](/docs/api/resources/events/sender-events#sender.failed) webhook events to track the outcome.

## Body parameters

<ParamField body="email" type="string" required>
  The email address to register as a sender. Must be a valid email address. Maximum 320 characters.
</ParamField>

## Returns

Returns a `201 Created` status code and [a sender object](/docs/api/resources/senders/object) on success, or an [error](/docs/api/errors) otherwise.

<RequestExample>
  ```json Request theme={null}
  // POST https://api.signatureapi.com/v1/senders
  // X-API-Key: key_test_...
  // Content-Type: application/json

  {
      "email": "jennifer@example.com"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  // 201 Created

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