DocuSign Declined or Voided Recovery
When a DocuSign envelope is declined or voided, the flow captures the reason, notifies the sender and account owner in Teams, creates a follow-up record, and updates the CRM stage so the deal is not lost. Turns failed signatures into a recovery workflow instead of a dead end.
Provided as-is, without warranty of any kind. Review and test each pattern in a non-production environment before deploying it to live automations. See our Terms.
Overview
This flow turns failed DocuSign signatures into a structured recovery workflow instead of a dead end. On a daily schedule it scans DocuSign for envelopes that were declined or voided, captures the recipient's reason, logs each one as a recovery record in Dataverse (carrying the CRM pipeline stage so the deal is re-engaged, not lost), and alerts the owner channel in Microsoft Teams so a human can act immediately.
Why it matters: a declined or voided envelope usually ends silently. Surfacing it with the reason, a follow-up record, and a stage change keeps the opportunity alive.
Ships Off (demo).
Use Case
A sales/operations team wants immediate, actionable handling of declined or voided agreements. Rather than discovering a dead deal weeks later, the team gets a same-day Teams alert plus a Dataverse recovery record with the decline reason and a re-engage stage, so the opportunity can be saved.
Flow Architecture
Daily Scan for Failed Envelopes
RecurrencePeriodic scan (every 1 day); tune frequency with the lookback days.
Initialize Trace & Config
Initialize variableMints a guid() correlation id and binds the DocuSign account/folder, recovery stage, lookback days, and status filter, plus Teams group/channel.
Search Declined or Voided Envelopes
DocuSign - SearchListEnvelopesReal connector call filtered to the configured statuses within the lookback window.
For Each Failed Envelope
Apply to eachCalls GetRecipientStatus to capture the decline reason, composes it with a fallback, creates a Dataverse recovery record (with CRM stage, correlation id, follow-up Open), and posts a recovery alert to Teams.
Environment Variables
| Schema name | Type | Default | Description |
|---|---|---|---|
| flowlibs_DocuSignAccountId | String | 00000000-0000-0000-0000-000000000000 | DocuSign account GUID for the DocuSign calls. Set per tenant. |
| flowlibs_DocuSignFolderId | String | sentitems | DocuSign folder read by Get Recipient Status (folder name or GUID). |
| flowlibs_RecoveryStage | String | Re-engage | CRM pipeline stage written onto each recovery record. |
| flowlibs_RecoveryLookbackDays | String | 7 | How many days back to search each run. |
| flowlibs_EnvelopeStatusFilter | String | declined,voided | Comma-separated DocuSign statuses treated as recoverable failures. |
| flowlibs_TeamsGroupId | String | <your-team-id> | Team (group) ID of the alert channel. |
| flowlibs_TeamsChannelId | String | <your-channel-id> | Channel ID of the alert channel. |
Connectors & Connections
| Connector | API name | Actions used |
|---|---|---|
| DocuSign | shared_docusign | SearchListEnvelopes GetRecipientStatus |
| Microsoft Dataverse | shared_commondataserviceforapps | CreateRecord |
| Microsoft Teams | shared_teams | PostMessageToConversation |
Note — All connections are referenced as solution connection references; the flow is portable between environments as long as a connection is mapped at import time.
Customization Guide
Almost every realistic variant of this flow can be implemented by changing environment variable values. A few cases require small edits inside the flow definition — those are called out explicitly below.
- Real CRM stage update
- Add a Dataverse or Salesforce UpdateRecord keyed on the opportunity tied to the envelope to push the Re-engage stage onto the deal.
- Auto-resend
- Chain DocuSign CreateEnvelopeFromTemplate / SendEnvelope to offer a corrected envelope automatically.
- Escalation
- Add a condition on envelope value/custom field to involve a manager (Approvals) for large deals.
- Reason analytics
- Point Power BI at the recoveries table to trend decline reasons over time.
- Scan cadence
- Raise the recurrence frequency and lower the lookback days together for near-real-time recovery.
Key Expressions
The flow is intentionally light on Power Fx / WDL gymnastics — the heaviest expressions are the branch-name concatenation and the approval outcome check. They are listed below in the order they appear in the flow.
EXPR.01Lookback window
Lower bound of the envelope search window.
EXPR.02Decline reason
Captures the recipient decline reason with a fallback.
EXPR.03Loop source
The declined/voided envelopes to process.
EXPR.04Correlation id
Minted once, propagated to every record and alert.
Comments
Sign in to join the conversation.
Sign inNo comments yet. Be the first to share your experience with this flow.