I’ve abandoned the the OAuth 2.0 route as it’s not necessary for my application.
Instead, I am using X-API-Key to send a request, seen here:
I keep getting this error after filling out all their info on their Swagger API docs (and testing):
A bit interesting… Anyone have a clue as to how I can fix this?
Hi Cameron,
As the error says the document needs at least one signer to successfully send out the document for signature. Since, you have stated that you have filled out all the fields, i suspect that it could due to some kind of syntax error.
So, i will attach a properly formed request and send it for sign using Swagger. In this document, I am sending this out to a single signer with single signature form field, the payload for signer will look like below.
{
"name": "Richard",
"emailAddress": "tenant@example.com",
"privateMessage": "A private message for the tenant",
"signerOrder": 1,
"enableEmailOTP": true,
"formFields": [
{
"id": "SignField",
"fieldType": "Signature",
"pageNumber": 1,
"bounds": {
"x": 100,
"y": 100,
"width": 100,
"height": 50
},
"isRequired": true
}
]
}
I’ve also attached a screenshot of the Swagger page with all of the inputs I used to send this request, and I received a successful response with a document ID and a 201 status code.
This is the final cURL generated for my request for your reference.
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 'DisableExpiryAlert=false' \
-F 'ReminderSettings.ReminderDays=3' \
-F 'BrandId=' \
-F 'ReminderSettings.ReminderCount=3' \
-F 'EnableReassign=true' \
-F 'Message=Please sign this document' \
-F 'Signers={
"name": "Richard",
"emailAddress": "tenant@example.com",
"privateMessage": "A private message for the tenant",
"signerOrder": 1,
"enableEmailOTP": true,
"formFields": [
{
"id": "SignField",
"fieldType": "Signature",
"pageNumber": 1,
"bounds": {
"x": 100,
"y": 100,
"width": 100,
"height": 50
},
"isRequired": true
}
]
}' \
-F 'ExpiryDays=60' \
-F 'EnablePrintAndSign=false' \
-F 'OnBehalfOf=' \
-F 'EnableSigningOrder=false' \
-F 'UseTextTags=false' \
-F 'SendLinkValidTill=' \
-F 'Files=@test-document.pdf;type=application/pdf' \
-F 'Title=Tenancy agreement' \
-F 'HideDocumentId=false' \
-F 'EnableEmbeddedSigning=false' \
-F 'ReminderSettings.EnableAutoReminder=false' \
-F 'DisableEmails=false'
Hope this helps.
Side note: I actually work for BoldSign. You can directly contact us and raise a ticket to get your doubts cleared immediately.
Support: https://support.boldsign.com/
Website: https://boldsign.com/
App: https://app.boldsign.com/
Very grateful for this! We ended up using HelloSign with similar protocols and it was much easier!
Thank you, again!