0

We use the rest API (https://demo.docusign.net/restapi) for sending envelopes. When a signer declines the envelope, the sender receives an email containing a default subject ('Declined: '). We would like to change the email subject to a custom text (only when declined).

I found some directions on https://support.docusign.com/en/answers/00086200 which states we could change the EnvelopeDeclined_Subject in the EmailResource, but we would prefer to provide the subject via the API instead.

Is this possible? And if so, how?

Willem van Hooijdonk
  • 95
  • 6

2 Answers2

1

No, you cannot change Subject via API just for Decline email notification. If you want hard coded Decline Message for all your envelopes then you can modify Email Resource File. Since Decline is one of the terminal state and once envelope reaches a terminal state then you cannot modify anything on an envelope.

Amit K Bist
  • 6,760
  • 1
  • 11
  • 26
1

It's not possible to customize the Email Subject for DocuSign Completed/Voided/Declined emails at runtime on a per-envelope basis purely by using the API. However, you can achieve somewhat "runtime" control over email contents by using Branding and customizing the Email Resource File to specify the subject for the Decline Envelope Email. At a high-level, you'd do this by doing the following:

  1. Use the DocuSign web UI to login as an Admin user and create a new Brand for the account.
  2. Edit the Email Resource File that's associated with the brand to specify the custom subject for the envelope completion email.
  3. When sending the Envelope via the API, specify brandId within the Create Envelope request to specify the id of the Brand you created in step 1 (and customized in step 2).

So, for example, let's say you had 5 different variations of email subject for Declined Envelopes -- and wanted to be able to specify (via the API) which one to use for each Envelope that you create/send via API. You'd create 5 separate Brands via the DocuSign web UI, customize the Email Resource File for each of those 5 brands (to specify the Email Subject to use for the Declined Envelope email), then when you create/send an Envelope with the API, set brandId to specify the Brand that contains the Declined Envelope subject that you want to use for that Envelope (if a signer declines to sign).

The answer on this SO thread contains additional info about this procedure, and the docs I've linked to above contain info about branding and the email resource file.

Kim Brandl
  • 13,125
  • 2
  • 16
  • 21