Search code examples
docusignapitunneling

Docusign developer webhook not allowing http

When setting up a webhook URL I need to use an http connection for my dev account. The docs clearly say that this is a valid option. Only the production env needs HTTPS but dev env can have HTTP or HTTPS See here and here.

I have tried on the account level where it will not even allow me to save the configs if URL is not https:

Docusign admin dev sandbox account

Also, when trying to set up the webhook on the envelope level:

$event_notification = new \DocuSign\eSign\Model\EventNotification(); 
$event_notification->setUrl("http://subdomain.app.webhook.com:8082/docusign/");
$envelope_definition->setEventNotification($event_notification);

This throws a failure which shows in the Failed Connect Notifications section in the admin sandbox as follows:

enter image description here

My feeling is that the port I'm using has something to do with it. I need to use that port for various tunneling reasons. But I'm not sure how it's affecting it and the error message I receive says clearly that uri needs to start with https, which is confusing coz in dev it doesn't.
Any help is appreciated.

Solution

  • You are referring to old links created before June 15, 2017, DocuSign has stopped supporting HTTP in Demo/Sandbox environment as well since June 15, 2017 for any new account created after this date in Demo or PROD. Please check DS Support link for the announcement.

    You need to set HTTPS only in DEMO or PROD, For Dev purpose, I would suggest to use either NGROK or get a free HTTPS certificates are available from the Let’s Encrypt project.