The Connect category enables your application to be called via HTTPS when an event of interest occurs.
Use the Connect service to "end the polling madness." With Connect, there is no need for your application to poll DocuSign every 15 minutes to learn the latest about your envelopes.
Instead, you register your interest in one or more types of envelope or recipient events. Then, when an interesting event occurs, the DocuSign platform will contact your application with the event's details and data. You can register interest in envelopes sent by particular users in your account, or for envelopes sent by any user.
To use the Connect service, your application needs to provide an https url that can be called from the public internet. If your application runs on a server behind your organization's firewall, then you will need to create a "pinhole" in the firewall to allow the incoming Connect calls from DocuSign to reach your application. Other techniques for receiving the incoming calls including proxy servers and DMZ networking can also be used.
Instead of registering a general Connect configuration and listener, an individual envelope can have its own Connect configuration. See the
eventNotification field for envelopes.
Use the Connect category for:
Get Connect Configuration Information
Updates a specified Connect configuration.
Creates a connect configuration for the specified account.
Get information on a Connect Configuration
Deletes the specified connect configuration.
Returns users from the configured Connect service.
Connect event logging information. This object contains sections for regular Connect logs and for Connect failures.
Republishes Connect information for the specified envelope.
Republishes Connect information for multiple envelopes.
Gets the Connect failure log information.
Deletes a Connect failure log entry.
Gets the Connect log.
Gets a list of Connect log entries.
Get the specified Connect log entry.
Deletes a specified Connect log entry.