New scheduled sending and delayed routing API endpoints
Use these new API endpoints to delete scheduled sending or delayed routing settings in your envelope workflows.
Table of contents
In this blog post, I’m excited to share new API functionality for our scheduled sending and delayed routing features.
Scheduled sending and delayed routing are features of Docusign Advanced Recipient Routing (ARR). ARR enables you to build complex routing flows, including pauses, conditional routing, and more.
In the API, options to control the routing flow of an envelope or template are specified by the workflow object. This object contains an array of workflowStep objects, each of which describes rules to be applied to a step in the routing order. To add scheduled sending to an envelope, set the scheduledSending object on the workflow object itself; to add a delay before a given step in the routing order, set the delayedRouting object on the corresponding workflow step.
Before this release, deleting your envelope’s scheduledSending or delayedRouting object required deleting the entire workflow object. Now, you can use one of several new API endpoints to delete or modify these rules at a more granular level.
Let’s walk through some common scenarios.
Delete delayed routing
If the delay has not yet begun, you have two options. You can use the new deleteEnvelopeDelayedRoutingDefinition endpoint to delete the delayedRouting object. Then, you’ll need to unpause the envelope. You can also delete the entire workflow step using the deleteEnvelopeWorkflowStepDefinition endpoint.
If the delay has already begun, you can use a simple workaround. Use the updateEnvelopeDelayedRoutingDefinition endpoint to update the delay/send time to one minute in the future. After a minute, your envelope will be sent!
Delete scheduled sending
If the scheduled sending countdown has not yet begun, call the new deleteEnvelopeScheduledSendingDefinition endpoint.
If the scheduled sending countdown has already begun, you can use another workaround. Call the updateEnvelopeScheduledSendingDefinition and set the scheduled send time to one minute in the future.
Additional resources
Eleanor is a programmer writer who has been at Docusign since 2021. She primarily works with Docusign developers to produce the API reference. She also loves her beagle. You can reach her on LinkedIn.
Related posts
Discover what's new with Docusign IAM or start with eSignature for free
