2022 Release Notes

Tip

For product feature and UI changes, refer to https://helpx.adobe.com/sign/release-notes/adobe-sign.html

System Requirement Changes

For browser and product UI system requirements, see https://helpx.adobe.com/sign/system-requirements.html.

Webhook changes

Date

Change

Nov. 8

Webhook conversion to a microservice (“webhooks 2.0”) with the following benefits:

  • Independent release cycles from the core code thereby supporting frequent and rapid updates, feature enhancements, and bug fixes, etc.

  • An independent and new UI with features that streamline webhook visibility and management.

  • Enhanced performance.

Webhooks 2.0 supports all the features of classic webhooks with one caveat: If a webhook was configured for the user, their group, or their account, classic webhooks delivered notifications to all agreement participants. In webhooks 2.0, ONLY webhooks configured for the sender, sender’s group, or the sender’s account will receive notifications. Current customers can try webhooks 2.0 on a Trial, Developer, or Sandbox account via Adobe’s Insider Access program.

Effective dates:

  • November 8th, 2022: All new customers will be onboarded to webhooks 2.0.

  • March 14th, 2023: All customers will be automatically migrated.

  • July 18th, 2023: Adobe sunsets the legacy webhooks infrastructure.

Note: Customers with strict network security policies must configure new IP addresses in accordance with https://helpx.adobe.com/sign/system-requirements.html.

Nov. 8

New webhooks:

  • AGREEMENT_REMINDER_INITIATED fires when an agreement reminder is triggered and reminder emails are suppressed.

  • MEGASIGN_REMINDER_SENT webhook fires when a Send in Bulk reminder is triggered and reminder emails are enabled (default).

  • MEGASIGN_REMINDER_INITIATED fires when a Send in Bulk reminder is triggered and reminder emails are suppressed (the default) ( Unlike MEGASIGN_REMINDER_SENT webhook fires when reminder emails are enabled). Only one MEGASIGN_REMINDER_INITIATED (or MEGASIGN_REMINDER_SENT) webhook is delivered for the parent Send in Bulk container. Individual child agreements do not each fire a MEGASIGN_REMINDER_INITIATED webhook.

Sept. 13

Support for webhook endpoints to communicate on port 8443 (in addition to 443) in order to support mTLS.

Sept. 13

POST /agreements/{agreementId}/ endpoint now supports an optional redirect URL which sends users to control a custom post-sending landing page instead of the default Acrobat Sign page. Developers can use the new postSendOption.redirectUrl for apps and integrations so that the sender redirects to a workflow-specific page, thereby both allowing the sender to remain in the integration (e.g. branded workflow), and providing a way for the developer to create a page where the sender can be notified about the sent status or modify the agreement (reminders, deadlines, etc.) Note a Sign setting needs to be made to allow these URLs to avoid open redirect security issues. The description of this setting is similar to: “the authorized URLs the application can redirect to after completing a workflow”. This option does not apply to Fill & Sign flows.

July

None

June

AGREEMENT_EXPIRATION_UPDATED (API only): A new webhook event provides notification updates for an agreement’s expiration time. It can only be subscribed to via the POST /webhooks API call.

June

AGREEMENT_SIGNER_NAME_CHANGED_BY_SIGNER: This new event triggers when a recipient changes the pre-populated name value when signing an agreement. Name values can be pre-populated through the API or through the require recipient name when sending option.

May

None

April

REMINDER_SENT: A new webhook event executes on REMINDER_SENT events either by explicitly subscribing to the AGREEMENT_REMINDER_SENT event or subscribing to AGREEMENT_ALL.

January

None

REST API changes

Date

Change

Nov. 8

New endpoints

  • DELETE /agreements/{agreementId} - A new endpoint that supports the “soft delete” function by moving an agreement and all related data(including database records and physical files) to the Deleted folder where it will be fully destroyed 14 days later (unless restored first).

  • GET /users/{userId}/settings - A new endpoint to obtain the authoring settings for a user.

Nov. 8

Updated endpoints

  • GET /libraryDocument/{libraryDocumentId}/combinedDocument - An update to the existing endpoint to add a value (skipDocumentSealing) that returns a non-certified PDF.

  • POST /libraryDocuments - An update to an existing endpoint that creates a library document from an agreement.

  • GET /groups - This endpoint has been expanded to support the new Shared Users queue by listing the account shares within a group.

Sept

The description of the BYON_NOTARY notaryType was updated to reflect the “bring your own” aspect of a customer-provided notary.

July

Devs can improve the delegation process by updating the delegation API to use the v6 REST endpoint delegatedParticipantSets. Customers should see no impact beyond enforcing the required name values configuration during delegation.

June

None

May

None

April

None

January

None

Bug fixes

September

No developer-specific bug fixes.

July

For product UI changes, see https://helpx.adobe.com/sign/release-notes/adobe-sign.html.

4355581: The reporting API for the new report system has been updated to better manage reports with null values. This enables account scoped report charts to list the reports showing their report ID.

4331709: Bug: A A MISC_SERVER_ERROR is generated when replacing a recipient with a userID that is auto-delegating their agreements to a user that is not an active userID in the system. Fix: Code has been improved to successfully identify and create the auto-delegate userID as a single-use user for the purpose of the transaction.

June

4333689 Web form creators are unable to delegate countersignature for web forms from the modern manage page due to the API not providing a signable reply when the signature is attempted.

4352684 The API call PUT /widgets/{widgetId}/formFields is not working for the SIGNATURE field.

4353564/4361472: The ability to create new accounts via POST/account was broken due to upstream settings updates.

May

None.

April

4328663 Customer accounts that have SAML set to Mandatory or SAML_ACTIVATE_PENDING_USERS = true can not inactivate users using the bulk edit feature in the Acrobat Sign system as the userIDs reactivate immediately after the update. Additional code has been added to ensure that only “Created” users can be immediately activated.

4331146 REST v6 GET Agreements > displayUserSetMemberInfos is blank for some drafts when workflows are designed with more potential recipients than are utilized due to email values being required.

4333575: Identity Verification Methods defined in Workflow (PHONE and ADOBE_SIGN) are not returned in REST v5 or v6 GET /workflows/{workflowId}

4333774 Multi-file agreements signed with a digital signature would not return a name-value when GET /agreements/{agreementID}/documents were called due to a null value in the document version reference. Agreements containing a digital signature now correctly contain a name property. For agreements created from multiple documents, the API will still return a single document for digitally signed agreements, and that document will now have the name listed as “multidoc.pdf”.

4335442 Error Code “MODIFYING_IMMUTABLE_FIELDS” is not listed in the swagger documentation for PUT /users/{userId} in REST v6

4336037 Calling GET /signingUrls after retrieving the agreement ID can generate an “AGREEMENT_NOT_SIGNABLE” status that can be inferred to indicate the agreement is in a terminal state. The conditions that trigger the status in these cases now trigger an “AGREEMENT_NOT_EXPOSED” status only.

4341807 The DISPLAY_EMAIL back-end value is being returned in response to /signingUrls. The function to capture the email of a participant has been updated to take this context into account.

4341947 There is no retryAfter in the response body for some API calls when they trip the throttling threshold. The managing method has been updated to include the retryAfter response.

4343205 Agreements sent with a custom email template and a link expiration set to 60 return a 500 error when the Send new Link button is used. The link expiration function in conjunction with custom email templates has been modified to eliminate the error.

January

4308773 Signing on the iOS mobile application could result in an “AUTO_CANCELLED_CONVERSION_PROBLEM” after the recipient signature was completed due to offline sync events that cause queued requests to be sent multiple times. Server-side code has been added to evaluate if a successful conversion process has completed for the same participation ID when a conversion times out, allowing for graceful resolution of conflicts.

4319974 The Locale selector on the signing page was still visible when the signingurl is retrieved using GET /signingurl v6 REST API due to the API call falling back to the application value instead of the session value. The API call has been updated to retrieve the setting value from the session (API user) instead of the application