/bff/document/send-by-email

Generic "deliver this blob to this contact as a PDF attachment" primitive. Resolves the blob + contact in the authenticated organisation, then dispatches the document-send workflow notification (e-mail body + attachment). The e-mail body uses the organisation's default template, which can be overridden per org under Settings → E-mail templates.

InvoicepostBffDocumentSend-by-email

Parameters

JSON body

Request body

application/json

blobTokenstringRequired

32-char token of the blob to attach.

Exampleabcdef0123456789abcdef0123456789

contactIdstringRequired

External contact id (CuRefNo, 16 chars) of the recipient.

ExampleaHRj9aHo9cXcTAqc

filenamestringOptional

Override the attachment filename and the body variable {{ documentFilename }}. Defaults to the blob's stored filename.

ExampleDoklad_2026001.PDF

Response schema

1 status code documented

200Success

successbooleanRequired

emailExternalIdstring | nullRequired

External id of the queued e-mail — null when the workflow template is missing.

One of 2:

Variant 1

string

Variant 2

null

Response example

application/json

{
  "success": false
}

Request example

POST /bff/document/send-by-email

post

curl -X POST "https://api.bizkithub.com/bff/document/send-by-email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "blobToken": "abcdef0123456789abcdef0123456789",
  "contactId": "aHRj9aHo9cXcTAqc",
  "filename": "Doklad_2026001.PDF"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key