Overview
Go-Live Checklist
Move a SignatureAPI integration from test to live mode: live keys, live webhooks and senders, retries, failure alerts and a data retention plan.
Test and live mode run the same API, so going live is mostly configuration. Live mode has its own envelopes, webhook endpoints and senders, which means everything you set up in test mode needs a live twin. Work through this list before your first live envelope.
Checklist
Go-live checklist
Set Up Live Senders
If your envelopes name a custom sender, register that address again with live mode on. Senders don’t carry over from test mode, and only a verified sender can appear on an envelope. Verification needs the address owner to click a link that SignatureAPI emails them, so start early. See the sender lifecycle.
Watch for Failures
A live envelope can fail after the API accepted it. Subscribe your live endpoint to the events that need someone’s attention, and alert on them:
| Event | What happened |
|---|---|
envelope.failed | The envelope hit an internal error and moved to failed. data.detail explains why. |
recipient.hard_bounced | The signing request email to a recipient was rejected. Fix the address and replace the recipient. |
recipient.rejected | A recipient declined to sign. |
deliverable.failed | The signed documents could not be generated. |
Also log every API error your code gives up on. Retries and errors explains which errors are worth retrying.
Decide How Long to Keep Data
SignatureAPI keeps envelopes and their documents until you delete them. Decide where your signed documents live and when you delete envelopes before real personal data starts to flow. See Data retention and deletion.
Run a Last Live Test
Send one live envelope to yourself and sign it. Check that the email arrives from the right sender with your branding, that your live endpoint receives the events, and that the signed PDF reaches the place you store it. A live envelope counts toward your plan.