Sender Lifecycle

The verification lifecycle of a sender.

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.

Status	Description
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.

Subscribe to sender.verified or sender.failed webhook events to track the outcome.