No webhook calls for deleted draft envelopes

0
votes

I saw this question Deleted Draft Envelopes have inaccurate status about deleted drafts, but I wanted to check if that's also true for webhooks.

If I create Draft Envelope in DocuSign from my application, and then user deletes that Envelope in DocuSign, will any webhook event fire?

These are the event notifications that I have specified when Draft Envelope is created or Envelope is sent:

{
  "eventNotification": {
    "envelopeEvents": [
      { "envelopeEventStatusCode": "completed" },
      { "envelopeEventStatusCode": "declined"  },
      { "envelopeEventStatusCode": "voided"    }
    ]
  }
}

I receive no webhook calls when draft is deleted.

But I do receive webhook calls from Docusign when Envelope is sent and

  • completed
  • declined
  • voided
2
docusignapi

2 Answers

2
votes

The behavior that's described in the other SO post that you've linked to (Deleted Draft Envelopes have inaccurate status) is 'by design'. That is, when a new Envelope is created/saved (but not sent), it's considered a draft Envelope and its status will be created. If the draft Envelope is subsequently deleted without ever being sent, its status will still be created -- there is no distinct status value that indicates a deleted draft Envelope.

Since webhooks fire in response to change in Envelope (or Recipient) status, and there is no change in status when a draft Envelope is deleted, you will never receive a webhook notification when a draft Envelope is deleted.

The behavior you've described in your post is 'by design' (as expected) re the event notifications that you've specified and the webhook calls you're receiving in response to the specified Envelope events.

1
votes

Can you describe your use case whereby you want your software application to be notified when a draft envelope has been deleted?