Business applications can use this service API to add a document to a document package linked to an enterprise user’s account. The document information is sent in the HTTP request header and document bytes are sent in the HTTP request body.  Note SigningHub will convert supported document formats to PDF if the header "x-convert-document" is set to a value of "true".  The only case supported where this value is set to "false" is to retain Word format and XML documents.

SigningHub supports a wide variety of document formats, each of which can be converted to PDF format upon upload.  Click here for the full list.

Note PDF documents are not altered upon upload to the system.

Note a package must already exist before you can add a document using this call.

https://api.signinghub.com/v3/packages/{package_id}/documents
HTTP Verb		POST
Content–Type		application/octet-stream
Accept		application/json
Authorization		Bearer {access token}
x-file-name		Test file.pdf
x-convert-document (optional)		true
x-source		API
Request Body		file (binary Stream)
Status Code	Message	Response Body
201	Created	{  "documentid": 123 }
400	Bad Request	{   "Message": "Request does not contain document" }
		{   "Message": "Invalid request headers - file name not found" }
		{   "Message": "Only XML document can be uploaded for a workflow which contains at least one XML document" }
401	Unauthorized	{   "Message": "Request authorization denied" }
		{   "Message": "User authentication required" }
403	Forbidden	{   "Message": "Enterprise admin's role does not allow managing integration" }
		{  "Message": "You are not allowed to perform the requested operation" }
		{   "Message": "Account is disabled" }
		{   "Message": "Your storage limit has been reached" }
		{    "Message": "Could not upload file  -  it is infected by malware" }
		{   "Message": "Your document upload size limit has been reached" }
500	Internal Server Error	{   "Message": "An internal server error occurred while processing the request" }