Skip to main content
POST
/
createNewTemplate
Create a template (API key auth). Optionally instantiate and send to recipients.
curl --request POST \
  --url https://api.useinkless.com/createNewTemplate \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form 'templateName=<string>' \
  --form 'fields=[
  {
    "id": "sig-1",
    "x": 144,
    "y": 418,
    "page": 1,
    "type": "Signature",
    "recipient": 1
  }
]' \
  --form document='@example-file' \
  --form 'emailSubject=<string>' \
  --form 'recipients={
  "name": "<string>",
  "email": "jsmith@example.com",
  "phone": "<string>"
}' \
  --form autoReleaseSignatures=true
{ "message": "Template created successfully", "template_id": "b4e2e25f-3a43-4e6c-9df9-3c6c1a2f13a1", "s3_url": "templates/final.pdf", "fields": [ [ { "id": "sig-1", "x": 144, "y": 418, "page": 1, "type": "Signature", "recipient": 1 } ] ] }

Documentation Index

Fetch the complete documentation index at: https://docs.useinkless.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Body

multipart/form-data
​
templateName
string
required

Name for the template.

​
fields
object[][]
required

Template fields grouped by recipient index. Each inner array corresponds to the fields for a recipient. Sent as JSON within multipart.

​
document
file

The template PDF file to upload. Note that you can also upload a DOCX file here but will be converted to a PDF.

​
emailSubject
string

Optional custom subject for the email sent to recipients.

​
recipients
object[]

Optional. If provided, immediately creates a document instance and notifies recipients.

​
autoReleaseSignatures
boolean

Optional. Default false if omitted.

Response

Success

​
message
string
required
Example:

"Template created successfully"

​
template_id
string<uuid>
required
​
s3_url
string
required

S3 key/path for the uploaded template PDF.

​
fields
object[][]
required