API REFERENCE / DOCUMENTS

Create document with signees

Creates a document by uploading a file via multipart and attaching signees in one step.

POST/api/documents/quick-createAPI key

Request

Authentication

filefilerequired

One file, at most 50 MiB. PDF is recommended for signing.

titlestring

If omitted or empty, the uploaded file name is used.

tenantIdstringrequired

folderIdstring

Folder in this tenant. Missing folders and folders in another tenant return 400; access is checked.

signingMethodstring

signingMessagestring

Personal message included in signing emails. Example: Please review and sign by Friday.

emailLanguagestring

Email language for this document. Defaults to the tenant email language when omitted.

signingOrderEnabledboolean

Enables sequential signing order when true.

signeesstringrequired

Provide a non-empty JSON array of signees. Each signee must include a valid email address and a name.

pic (personal identity code) is optional, including when signingMethod is strong. Include it only when you want to require the signer’s verified personal identity code to match an expected value.

With pic: Bink compares the supplied code with the code returned by strong identification. Signing is blocked if the verified code is missing or does not match.

Without pic: the signer still completes strong identification, but no match against a sender-supplied code is required. You can make this choice separately for each signee. Personal identity codes are not included in signee responses.

Signee example

[
  {
    "email": "john.doe@example.com",
    "name": "John Doe",
    "pic": "010101-123X"
  },
  {
    "email": "jane.doe@example.com",
    "name": "Jane Doe"
  }
]

When signingOrderEnabled is true, signees sign in the order listed in this array, starting with the first entry.

sandbox

https://sandbox-api.bink.fi

Live response

⌁

Your response will appear here.

Send a request to the selected environment.

Request example

cURL

curl -X POST 'https://sandbox-api.bink.fi/api/documents/quick-create' \
  -H 'Accept: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'file=@agreement.pdf' \
  --form-string 'signees=[
  {
    "email": "alex@example.com",
    "name": "Alex Example"
  }
]'

Examples use a placeholder key. Replace it in your application.

Response reference

Example JSON

{
  "message": "Document created",
  "document": {
    "downloadUrl": "https://storage.example.com/agreement.pdf?signature=example",
    "emailLanguage": "fi",
    "id": "cfc80de9-1e3f-4c72-b490-73381c1702da",
    "tenantId": "3e02f5b5-162a-4ff1-b343-03bbf032d4a1",
    "folderId": null,
    "name": "Example agreement",
    "status": "draft",
    "pinned": null,
    "createdAt": "2026-09-23T09:00:00.000Z",
    "updatedAt": "2026-09-23T09:00:00.000Z",
    "source": "uploaded",
    "userId": "f675ae71-6cb0-4266-a9af-e82759bf6d90",
    "signingMethod": "email",
    "signingMessage": null,
    "signingOrderEnabled": null,
    "signingGroupsEnabled": false,
    "reminderCooldownUntil": null,
    "file": "tenants/TENANT_ID/documents/agreement.pdf",
    "originalFile": "agreement.pdf",
    "hash": null
  },
  "signees": [
    {
      "id": "9383ca59-9ce2-493f-b2de-527cf837c352",
      "documentId": "cfc80de9-1e3f-4c72-b490-73381c1702da",
      "email": "alex@example.com",
      "name": "Alex Example",
      "status": "pending",
      "userId": "f675ae71-6cb0-4266-a9af-e82759bf6d90",
      "signingOrder": null,
      "signingGroupId": null,
      "signedAt": null,
      "createdAt": "2026-09-23T09:00:00.000Z",
      "updatedAt": "2026-09-23T09:00:00.000Z"
    }
  ],
  "contentType": "application/pdf"
}

Response schema

message stringrequired

document objectrequired

Nested fields

downloadUrl string | null

Short-lived signed URL for downloading the uploaded document.

emailLanguage string | null

Document-specific email language. Null means tenant email language is used.

fiensv

id stringrequired

tenantId string | null

folderId string | null

name string | null

status stringrequired

signedpending_sealin_processdraft

pinned boolean | null

createdAt stringrequired

updatedAt stringrequired

source string

uploadededitor

userId string | null

signingMethod string | null

emailstrong

signingMessage string | null

signingOrderEnabled boolean | null

signingGroupsEnabled boolean

reminderCooldownUntil string | null

file string

Storage object key. Use downloadUrl for downloads.

originalFile string

hash string | null

signees arrayrequired

Nested fields

Array of:

id stringrequired

documentId stringrequired

email string | null

name string | null

status stringrequired

pendingsigneddeclined

userId string | null

signingOrder integer | null

signingGroupId string | null

signedAt string | null

createdAt stringrequired

updatedAt stringrequired

contentType string | nullrequired

INTEGRATION NOTE

Creating a document does not send invitations. Use send-for-signing with the returned document ID.

Learn more

Confirm production request

This will run Create document with signees (multipart) against production and may consume credits, send invitations, or permanently delete data.

POST https://sandbox-api.bink.fi/api/documents/quick-create