cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

This documentation is for the new preview UI. It’s still being refined and is subject to change. For documentation for the old UI, see Knowledge Base.

Article link copied to clipboard
Updated
Published
15 min read
Note on third‑party tools

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

Adobe Acrobat Sign is an e-signature management solution. Use the Adobe Acrobat Sign component to send, sign, track, and manage the signature process.

Connections

OAuth 2.0

OAuth 2.0 flow

To configure OAuth for Sign, begin by creating an App:

  1. Log in to Acrobat Sign.
  2. Select API from the top menu. If you do not see the API link, select Account
  3. Select API Applications.
  4. Select the Create (+) icon at the top right of the table and provide details about your app.
  5. Choose a domain based on the intended use:
  6. CUSTOMER: Apps that only access your account or are used for internal use and testing.
  7. PARTNER: Select this type if you're developing an application for other users and your app needs access to other Acrobat Sign accounts.
    Note: PARTNER applications must be certified to have full access to other accounts.

To Retrieve the OAuth Client ID and Secret:

  1. In the API Applications menu, select the application.
  2. Click Configure OAuth for the Application link to configure your OAuth integration.
  3. For the redirect URI enter https://oauth2.flowbuilder.eu.lansweeper.com/callback for EU sites or https://oauth2.flowbuilder.us.lansweeper.com/callback for US sites.
  4. check the boxes for the necessary scopes needed with the modifier set to account for the integration and save.
  5. in the API Applications menu, select the application and select View / Edit.
  6. Enter the Application ID/Client ID and Client Secret Values into the connection configuration of the integration.
  7. Client ID and Application ID are the same value and can be used interchangeably.
  8. Enter the scopes

This connection uses OAuth 2.0, a common authentication mechanism for integrations.
Read about how OAuth 2.0 works here.

Input Comments Default
Authorize URL The OAuth 2.0 Authorization URL for Acrobat Sign with the correct region/shard (this can be found in the URL when you are logged into the Adobe Sign web app). For example, if the URL is https://secure.na3.adobesign.com, the authorize URL would be 'https://secure.na3.adobesign.com/public/oauth/v2' https://secure.na3.adobesign.com/public/oauth/v2
Token URL The OAuth 2.0 Token URL for Acrobat Sign with the correct region/shard (this can be found in the URL when you are logged into the Adobe Sign web app). For example, if the URL is https://secure.na3.adobesign.com, the token URL would be 'https://secure.na3.adobesign.com/oauth/v2/token' https://secure.na3.adobesign.com/oauth/v2/token
Refresh URL The OAuth 2.0 Refresh URL for Acrobat Sign with the correct region/shard (this can be found in the URL when you are logged into the Adobe Sign web app). For example, if the URL is https://secure.na3.adobesign.com, the token URL would be 'https://secure.na3.adobesign.com/oauth/v2/refresh' https://secure.na3.adobesign.com/oauth/v2/refresh
Scopes Space separated OAuth 2.0 permission scopes for Acrobat Sign. Add scope modifiers using colons. https://opensource.adobe.com/acrobat-sign/developer_guide/gstarted.html#configure-scopes user_read:account user_write:self agreement_read:group
Client ID Client Identifier of your Acrobat Sign App (shown as Application ID inside Acrobat Sign)
Client Secret Client Secret of your Acrobat Sign App

Triggers

Webhook

Receive and validate webhook requests from Adobe Sign for webhooks you configure.

Input Comments Default
Connection
Perform Strict Validation Set to true if you need to perform strict validation on each webhook notification. false

Actions

Create Account

Creates an Acrobat Sign account under the partner channel.

Input Comments Default
Connection
Account Type The type of account to be created.
Country Code The country code of the account.
External ID Case-sensitive External ID for which you would like to retrieve agreement information. ExternalId is passed in the call to the agreement creation API. (Note: the externalId value is visible to all participants through the API, so should not be used to contain a sensitive token)
Locale The locale of the user.
Trial Duration Days Account trial duration (in days).
Email The email address of the user to be created.
First Name The first name of the user.
Last Name The last name of the user.
Phone The phone number of the user.
Title The job title of the user.
Number of Seats The number of seats.
Company The company of the user.

Create Agreement

Creates an agreement. Sends it out for signatures and returns the agreementId in the response to the client.

Input Comments Default
Connection
Transient Document ID ID for a transient document that will be added to the agreement.
Agreement Name Name of the Agreement that will be used to identify it.
Participant Set Info Role Role assumed by all participants in this set (signer, approver, etc.)
Participant Member Info Email Email address of the participant.
Signature Type The type of signature you would like to request - written or e-signature.
Agreement State State of the agreement.

Create Group

Creates a new group in an account.

Input Comments Default
Connection
Group Name The name of the group.
Created Date of creation of the group. Format would be yyyy-MM-dd'T'HH:mm:ssZ
Is Default Group true if the group is default group.

Create Transient Document

Uploads a document and obtains the document's ID.

Input Comments Default
Connection
File The file part of the multipart request for document upload. You can upload only one file at a time.
Mime Type The mime type of the document being uploaded. If not specified here then mime type is picked up from the file object. If mime type is not present there either then mime type is inferred from the file extension.
File Name A name for the document being uploaded. Maximum number of characters in the name is restricted to 255.

Create User

Creates a new user in the Acrobat Sign system.

Input Comments Default
Connection
Email The email address of the user to be created.
Account Admin true if the user is account admin. false
Company The company of the user.
First Name The first name of the user.
Last Name The last name of the user.
Initials The initials of the user.
Locale The locale of the user.
Phone The phone number of the user.
Title The job title of the user.
Account ID The account id of the user.

Create Webhook

Creates a webhook.

Input Comments Default
Connection
Webhook Subscription Events The list of events for which the webhook subscription is being made.
Scope Scope of the webhook.
Webhook Name The name of the webhook.
Webhook URL The URL to which the webhook payload is to be delivered.
Application Display Name The name of the application through which the webhook is created
Application Name The name of the application through which the webhook is created
Problem Notification Emails The list of email addresses to which the webhook problem is to be notified.
Resource ID Id of the resource type for which you want to create webhook. Provide agreementId if webhook needs to be created for an agreement. Similarly, widgetId if webhook needs to be created for a web form,megaSignId if webhook needs to be created for a bulk send and libraryDocumentId if webhook needs to be created for a library document. NOTE: Need to specify only if scope is 'RESOURCE'.
Webhook Resource Type The type of resource being accessed. (Note: need to specify this only if scope is Resource).
Webhook Agreement Conditional Parameters Conditions which webhook creator can specify for the payload while creating or updating a webhook.
Webhook Library Documents Conditional Parameters Conditions which webhook creator can specify for the payload while creating or updating a webhook.
Webhook MegaSign Conditional Parameters Conditions which webhook creator can specify for the payload while creating or updating a webhook.
Webhook Widget Conditional Parameters Conditions which webhook creator can specify for the payload while creating or updating a webhook.

Delete Agreement Documents

Deletes all the documents for an agreement.

Input Comments Default
Connection
Agreement ID The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. If provided

Delete Group

Delete an existing group.

Input Comments Default
Connection
Group ID The unique identifier of the group.

Delete Webhook

Deletes a webhook.

Input Comments Default
Connection
Webhook ID The webhook identifier, as returned by the Adobe Sign Webhook API.

Download Agreement PDF

Downloads the PDF associated with an agreement.

Input Comments Default
Connection
Agreement ID The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. If provided

Get Account

Retrieves the information for an account.

Input Comments Default
Connection
Account ID The account id of the user.

Get Agreement

Retrieves the current status of an agreement.

Input Comments Default
Connection
Agreement ID The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. If provided

Get Group

Retrieves detailed information about the group.

Input Comments Default
Connection
Group ID The unique identifier of the group.

Get User

Retrieves detailed information about the user in the caller account.

Input Comments Default
Connection
User ID The user identifier, as returned by the user creation API or retrieved from the API to fetch users. If provided

Get Webhook

Retrieves the details of a webhook.

Input Comments Default
Connection
Webhook ID The webhook identifier, as returned by the Adobe Sign Webhook API.

List Agreements

Retrieves agreements for the user.

Input Comments Default
Connection
Cursor Used to navigate through pagination. If not provided, it will default to the first page.
Page Size The number of results to return per page. If not provided, it is decided by your application settings.
External ID Case-sensitive External ID for which you would like to retrieve agreement information. ExternalId is passed in the call to the agreement creation API. (Note: the externalId value is visible to all participants through the API, so should not be used to contain a sensitive token)
Group ID The group identifier, as returned by the group creation API or retrieved from the API to fetch groups. If provided
Show Hidden Agreements A query parameter to fetch all the hidden agreements along with the visible agreements. Default value is false. false

List Group Events

Retrieves all events for group

Input Comments Default
Connection
Group ID The unique identifier of the group.
Cursor Used to navigate through pagination. If not provided, it will default to the first page.
Page Size The number of results to return per page. If not provided, it is decided by your application settings.

List Groups

Retrieve a list of groups in the Adobe Sign account.

Input Comments Default
Connection
Cursor Used to navigate through pagination. If not provided, it will default to the first page.
Page Size The number of results to return per page. If not provided, it is decided by your application settings.

List Group Users

Retrieves all the users in a group.

Input Comments Default
Connection
Group ID The unique identifier of the group.
Cursor Used to navigate through pagination. If not provided, it will default to the first page.
Page Size The number of results to return per page. If not provided, it is decided by your application settings.

List Users

Retrieves all the users in an account.

Input Comments Default
Connection
Cursor Used to navigate through pagination. If not provided, it will default to the first page.
Page Size The number of results to return per page. If not provided, it is decided by your application settings.

List Webhooks

Retrieves webhooks for a user.

Input Comments Default
Connection
Show Inactive Webhooks A query parameter to fetch all the inactive webhooks along with theactive webhooks. Default value is false. false
Scope Filter for webhooks with a specific scope.
Webhook Resource Type The type of resource being accessed. (Note: need to specify this only if scope is Resource).
Cursor Used to navigate through pagination. If not provided, it will default to the first page.
Page Size The number of results to return per page. If not provided, it is decided by your application settings.

Raw Request

Send raw HTTP request to Adobe Acrobat Sign

Input Comments Default
Connection
URL Input the path only (/agreements), The base URL is already included. For example, in order to send a agreements request, only /agreements is entered in this field.
Method The HTTP method to use.
Data The HTTP body payload to send to the URL.
Form Data The Form Data to be sent as a multipart form upload.
File Data File Data to be sent as a multipart form upload.
File Data File Names File names to apply to the file data inputs. Keys must match the file data keys above.
Query Parameter A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Header A list of headers to send with the request.
Response Type The type of data you expect in the response. You can request json, text, or binary data. json
Timeout The maximum time that a client will await a response to its request
Retry Delay (ms) The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. 0
Retry On All Errors If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. false
Max Retry Count The maximum number of retries to attempt. Specify 0 for no retries. 0
Use Exponential Backoff Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. false

Search Resources

Retrieves, searches, filters and sorts agreements for the user

Input Comments Default
Connection
Ownership Scope Ownership scope of the agreement documents to include in this search request. Default is 'OWNED'.
External ID A filter against case-sensitive external id for which you would like to retrieve agreement asset information. External id is passedin the call to the agreement asset creation API. Supply them in acomma-separated manner.
Group ID A filter against group identifier(s), as returned by the group creation API or retrieved from the API to fetch groups.
Asset ID(s) A filter against case-sensitive agreement asset id for which you would like to retrieve the information.
Library Document ID A filter against case-sensitive library document id that was usedto create an agreement. This filter will only apply for the sender of theagreement since signers don't have the knowledge of how the agreement wascreated. Also, this filter only applies to library documents with type DOCUMENT but not FORM_FIELD_LAYER
Page Size The number of results to return per page. If not provided, it is decided by your application settings.
Parent ID A filter against case-sensitive parent id for which you would like to retrieve agreement asset information.
Participant Email A filter against participant emails for which you would like to retrieve agreement asset information.
Queryable Fields A list of field names against which string query specified in the 'query' field above is executed. For more information, please refer here: https://helpx.adobe.com/sign/using/adobesign-search-users-agreements.html#NamePrefix
Role A filter against the roles the user has on agreement assets
Sort By Field Defines the field by which the results will be ordered
Sort Order Sets the direction of the order
Start Index 0-based first row (offset) of the search results to return. The value must be greater than or equal to 0 and less than 10000. If not provided, the default value is 0 and returns results from the very first row, without offset
Status A filter against the detailed status of the agreement asset.PLEASE note that PARTIAL and DRAFT agreements are not supported for search
Sub Types A filter against the agreement asset sub types. Only agreement assets with type LIBRARY_TEMPLATE currently have this field populated.
Type A filter against the agreement asset type.
User ID A filter against the user for account sharing. (Comma-separated)
Visibility A filter indicating the visibility level of agreements that get returned in the response.
Workflow ID A filter against case-sensitive workflow id for which you wouldlike to retrieve agreement asset information. Workflow id is passed in the call to the agreement asset creation API.
Query This field provides text search capibility against termsin the field values of agreements that are visibile to the usermaking the request. To find more about how text searching works please refer here: https://helpx.adobe.com/sign/using/adobesign-search-users-agreements.html#HowSearchWorks
Created Greater Than Date The maximum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.Range terms can be defined as less-than/greater-than or min/max.If terms are mixed the JSON will be considered malformed.
Expiration Greater Than Date The maximum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.Range terms can be defined as less-than/greater-than or min/max.If terms are mixed the JSON will be considered malformed.
Modified Greater Than Date The minimum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.
Created Less Than Date The maximum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.Range terms can be defined as less-than/greater-than or min/max.If terms are mixed the JSON will be considered malformed.
Expiration Less Than Date The maximum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.Range terms can be defined as less-than/greater-than or min/max.If terms are mixed the JSON will be considered malformed.
Modified Less Than Date The minimum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.
Created Max Date The maximum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.Range terms can be defined as less-than/greater-than or min/max.If terms are mixed the JSON will be considered malformed.
Expiration Max Date The maximum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.Range terms can be defined as less-than/greater-than or min/max.If terms are mixed the JSON will be considered malformed.
Modified Max Date The minimum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.
Created Min Date The minimum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.Range terms can be defined as less-than/greater-than or min/max.
Expiration Min Date The maximum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.Range terms can be defined as less-than/greater-than or min/max.If terms are mixed the JSON will be considered malformed.
Modified Min Date The minimum allowed date-time that is allowed in the result set. Values for each range field must adhere to the ISO-8601 standard.

Update Agreement

Updates the agreement in draft state, or update the expiration time on an existing agreement that is already out for signature.

Input Comments Default
Connection
Transient Document ID ID for a transient document that will be added to the agreement.
Participant Set Info Role Role assumed by all participants in this set (signer, approver, etc.)
Signature Type The type of signature you would like to request - written or e-signature.
Agreement State State of the agreement.
Expiration Date A range filter against the agreement expiration date.Format would be date-time with an offset from UTC/Greenwich in theISO-8601 format, such as 2007-12-03T10:15:30+01:00.Range terms can be defined as less-than/greater-than or min/max.
Agreement ID The agreement identifier, as returned by the agreement creation API or retrieved from the API to fetch agreements. If provided

Update Group

Update an existing group.

Input Comments Default
Connection
Group ID The unique identifier of the group.
Group Name The name of the group.
Created Date of creation of the group. Format would be yyyy-MM-dd'T'HH:mm:ssZ
Is Default Group true if the group is default group.

Update User

Update a user in the Acrobat Sign system.

Input Comments Default
Connection
Email The email address of the user to be created.
Company The company of the user.
First Name The first name of the user.
Last Name The last name of the user.
Initials The initials of the user.
Locale The locale of the user.
Phone The phone number of the user.
Title The job title of the user.
User ID The user identifier, as returned by the user creation API or retrieved from the API to fetch users. If provided
Status Status of the user.

Update Webhook

Updates a webhook

Input Comments Default
Connection
Webhook Subscription Events The list of events for which the webhook subscription is being made.
Scope Scope of the webhook.
Webhook Name The name of the webhook.
Webhook URL The URL to which the webhook payload is to be delivered.
Application Display Name The name of the application through which the webhook is created
Application Name The name of the application through which the webhook is created
Problem Notification Emails The list of email addresses to which the webhook problem is to be notified.
Webhook ID The webhook identifier, as returned by the Adobe Sign Webhook API.
Webhook Agreement Conditional Parameters Conditions which webhook creator can specify for the payload while creating or updating a webhook.
Webhook Library Documents Conditional Parameters Conditions which webhook creator can specify for the payload while creating or updating a webhook.
Webhook MegaSign Conditional Parameters Conditions which webhook creator can specify for the payload while creating or updating a webhook.
Webhook Widget Conditional Parameters Conditions which webhook creator can specify for the payload while creating or updating a webhook.