Apply branding to documents using API
The branding feature in BoldSign empowers you to personalize the appearance of emails sent to recipients, including elements like logos, background colors, and button colors.
BoldSign also supports the creation of multiple brands within the same account.
Create a brand in the web app or API
To create a brand using the web app, follow the guide on how to Create a Brand in the BoldSign Web App.
If you prefer to create a brand using the API, refer to the guide Create a Brand via API.
Applying the branding ID to the document
After successfully creating a brand, a brand ID will be generated. This brand ID will be used to associate the brand with a specific document.
Here are example codes that you can use for this purpose:
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 'BrandId= {your brand ID}' \
-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 BrandId
with the actual brand ID that you want to apply to the document. Execute the curl command while ensuring to provide the necessary fields such as Files
, Title
, and Signers
. By doing so, the desired brand will be seamlessly applied to the created document. Subsequently, the signer will receive an email containing the brand logo, and the same brand logo will be prominently displayed on the signing page of the document.
For a visual reference, please take a look at the branding logo located in the top left corner of the document, as shown in the following image.