Articles in this section
Category / Section

Send document on behalf of others using API

Published:
2 mins read

BoldSign enables performing actions on behalf of another user, enhancing document management. This feature enables users to dispatch documents on behalf of other individuals.

To make use of this feature, it’s necessary to obtain approval from an individual to use their email address to send documents on their behalf.

Follow the steps below to send document on behalf of other individual:

Create sender identity

Create a sender identity by using the name and email address of the individual to send documents on their behalf.

Here are example codes you can use to create a sender identity.

Code snippet

curl -X 'POST' \
 'https://api.boldsign.com/v1/senderIdentities/create' \
 -H 'accept: */*' \
 -H 'X-API-KEY: {your API key}' \
 -H 'Content-Type: application/json;' \
 -d '{
 "name": "Sender identity",
 "email": "senderidentity@email.com"
}'

In the above example, replace the name and email with the name and email of the individual that you want to send the documents on their behalf. Then, provide the notificationSettings to customize how sender identity should recieve email notification for the documents sent on behalf of them. For example, if viewed is set to true, an email will be automatically sent to the sender identity email address when the document is viewed by the signers.

After executing the above request, an approval email will be sent to the mentioned email address. Using the link within this email, the sender can assess the request and provide authorization for you to send documents using their email address. Once the sender grants approval, the requesting user gains the ability to send documents on behalf of the approving user.

Send document on behalf of others

Now, users can send documents on behalf of another user by including the sender’s identity email address in the OnBehalfOf property.

Here are example codes you can use to do this:

Code snippet

curl -X 'POST' \ 'https://api.boldsign.com/v1/document/send' \
    -H 'accept: application/json' \
    -H 'X-API-KEY: {your API key}' \
    -H 'Content-Type: multipart/form-data' \
    -F 'OnBehalfOf=' \
    -F 'Message=' \
    -F 'Signers={
       "name": "Hanky",
       "emailAddress": "hankyWhites@cubeflakes.com",
       "signerType": "Signer",
       "formFields": [
          {
               "id": "string",
               "name": "string",
               "fieldType": "Signature",
               "pageNumber": 1,
               "bounds": {
                 "x": 50,
                 "y": 50,
                 "width": 1,
                 "height": 1
                  },
     "isRequired": true
   }
 ],
 "locale": "EN"
}' \
 -F 'Files={your file}' \
 -F 'Title={title}' \

In the above example, replace the OnBehalfOf with the email address of sender identity.

After executing the above code, the document will be created, and an email will be sent to the signer. The sender’s identity email address will be used as the sender’s address in the email. Subsequently, the signer will see the sender identity email address as the sender of the email and the document, rather than your own email address.

Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
Access denied
Access denied