ADOBESIGNSEND Workflow Application
The ADOBESIGNSEND workflow application lets you send one or multiple documents to Adobe Sign for electronic signature.
- The ADOBESIGNSEND creates a single envelope and sends it to one or multiple signers.
- You can specify one or multiple files per ADOBESIGNSEND action. To do this, use the
FILEx
parameter, wherex
corresponds to the file number (e.g.FILE1
). At least one file is required. - You can specify one or multiple signers. To do this, use the combination of
SIGNER_NAME_LIST
andSIGNER_EMAIL_LIST
. You can also useSIGNER_NAMEx
andSIGNER_EMAILx
, wherex
corresponds to the signer number. - You can specify one role per recipient. To do this, based on the method that you use to specify signers (with or without
_LIST
), you can useSIGNER_ROLE_LIST
orSIGNER_ROLEx
, wherex
corresponds to the signer number. Possible values:SIGNER
(default),APPROVER
,ACCEPTOR
,CERTIFIED_RECIPIENT
,FORM_FILLER
orDELEGATE_TO_SIGNER
,DELEGATE_TO_APPROVER
,DELEGATE_TO_ACCEPTOR
,DELEGATE_TO_CERTIFIED_RECIPIENT
,DELEGATE_TO_FORM_FILLER
, orSHARE
. - Application logs are available. These can be specified by setting the value of the
AdobeSignSendLogLevel
parameter in theweb.config
file to0
to deactivate logs,1
for error logs,2
for information logs, or3
for debug logs; the default value is0
.
- 1.In the Adobe Sign administration interface, add a new
API Application
, then click Configure OAuth for application. - 2.Activate the following scopes and select
account
under Modifier:agreement_write
agreement_read
- 3.You can retrieve the
Client ID
andClient Secret
directly from the configuration tab. - 4.Insert a valid address in the Redirect URI field; it will be useful in the next step.

Application OAuth configuration
Since Adobe Sign doesn't support
client_credentials
authentication, it's necessary to use a refresh token in order to retrieve a valid access_token
. The refresh token is valid for 60 days. These 60 days are renewed upon each API call, which means that when you run ADOBESIGNSEND or ADOBESIGNCHECK, the token's validity is extended by 60 days.In order to be able to use your new Adobe Sign application, you need to authorize it to access the defined
scopes
. Execute the following URL in your browser:<HOST_SERVER>/public/oauth?redirect_uri=<REDIRECT_URI>&client_id=<CLIENT_ID>&response_type=code&scope=agreement_read:account+agreement_write:account
Replace the following information with your own values:
<HOST_SERVER>
: Your Adobe Sign account's host server. Usually, the URL is composed like this:https://api.naX.adobesign.com
, whereX
is the server ID.<REDIRECT_URI>
: The URL that you defined in your Adobe Sign application.<CLIENT_ID>
: Your Adobe Sign application's client ID.
After granting consent to your application, you'll be redirected to your
REDIRECT_URI
with a CODE
parameter in the URL.The code returned by Adobe Sign is for one-time use and will be used to obtain the refresh token.
In order to obtain the refresh token, execute the following request, specifying your values:
curl --location --request POST '<HOST_SERVER>/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'code=<CONSENT_CODE>' \
--data-urlencode 'client_id=<CLIENT_ID>' \
--data-urlencode 'client_secret=<CLIENT_SECRET>' \
--data-urlencode 'redirect_uri=<REDIRECT_URI>' \
--data-urlencode 'grant_type=authorization_code'
HOST_SERVER
: Your Adobe Sign account's host server. Usually, the URL is composed like this:https://api.naX.adobesign.com
, whereX
is the server ID.<CONSENT_CODE>
: One-time use code obtained in the previous step (Consent and obtaining a one-time code).<CLIENT_ID>
: Client ID of your Adobe Sign application.<CLIENT_SECRET>
: Your Adobe Sign application's client secret.<REDIRECT_URI>
: The URL that you defined in your Adobe Sign application.
After executing the request, you'll obtain a value for the refresh token, contained in the
refresh_token
data.If your refresh token has expired, you'll need to perform the preceding operations again.
You can use one of the following two configurations: with a list of signers or with signer numbers.
Parameter | Type | Direction | Description |
SIGNER_NAME_LIST | TEXT | IN | Names of signers, separated by the value defined in the DATA_SEPARATOR parameter |
SIGNER_EMAIL_LIST | TEXT | IN | Email addresses of signers, separated by the value defined in the DATA_SEPARATOR parameter. |
FILEx | FILE | IN | File(s) to send, where x corresponds to the file number; you can add one or multiple files |
Parameter | Type | Direction | Description |
SIGNER_NAMEx | TEXT | IN | Name(s) of the signer(s), where x corresponds to the signer number; you can add one or multiple signers |
SIGNER_EMAILx | TEXT | IN | Email address(es) of the signer(s), where x corresponds to the signer number; you can add one or multiple signers |
FILEx | FILE | IN | File(s) to send, where x corresponds to the file number; you can add one or multiple files |
Parameters | Type | Direction | Description |
ADOBESIGN_CLIENT_ID | TEXT | IN | Adobe Sign client ID client Adobe Sign
By default, this value comes from the AdobeSignClientId parameter in the web.config file. |
ADOBESIGN_CLIENT_SECRET | TEXT | IN | Adobe Sign client secret
By default, this value comes from the AdobeSignClientSecret parameter in the web.config file. |
ADOBESIGN_REFRESH_TOKEN | TEXT | IN | Authentication refresh token
By default, this value comes from the AdobeSignAuthServer parameter in the web.config file. |
ADOBESIGN_HOST_SERVER | TEXT | IN | Adobe Sign host server (e.g. https://api.naX.adobesign.com , where X is the server ID) By default, this value comes from the AdobeSignHostServer parameter in the web.config file. |
Parameters | Type | Direction | Description |
DATA_SEPARATOR | TEXT | IN | Separator used to the separate the contents of SIGNERS_NAME_LIST , SIGNERS_EMAIL_LIST , and SIGNER_ROLE_LIST
Default: , (comma) |
SIGNER_ROLE_LIST | TEXT | IN | Roles of the signers, separated by the value defined in the DATA_SEPARATOR parameter |
SIGNER_ROLEX | TEXT | IN | Role(s) of the signer(s), where x corresponds to the signer number; you can add one or multiple signers |
AGREEMENT_NAME | TEXT | IN | Name of the agreement, which will be displayed in the email sent to the user
Default: WorkflowGen |
Parameter | Type | Direction | Description |
ADOBESIGN_AGREEMENT_ID | TEXT | OUT | Contains the Adobe Sign agreement ID; you can use this ID in the ADOBESIGNCHECK workflow application |
Parameter | Type | Direction | Value |
SIGNER_NAME_LIST | TEXT | IN | John Smith,Bernard Martin |
SIGNER_EMAIL_LIST | TEXT | IN | |
SIGNER_ROLE_LIST | TEXT | IN | APPROVER,SIGNER |
FILE1 | FILE | IN | contract.pdf |
ADOBESIGN_AGREEMENT_ID | TEXT | OUT | xxxxx-xxxxx-xxxxx-xxxxx |
Parameter | Type | Direction | Value |
SIGNER_NAME1 | TEXT | IN | John Smith |
SIGNER_NAME2 | TEXT | IN | Bernard Martin |
SIGNER_EMAIL1 | TEXT | IN | |
SIGNER_EMAIL2 | TEXT | IN | |
SIGNER_ROLE1 | TEXT | IN | APPROVER |
SIGNER_ROLE2 | TEXT | IN | SIGNER |
FILE1 | FILE | IN | contract.pdf |
ADOBESIGN_AGREEMENT_ID | TEXT | OUT | xxxxx-xxxxx-xxxxx-xxxxx |
Last modified 4mo ago