/bff/contract/create

Creates a new contract in draft status. The organisation internal contact is automatically added as the issuer party. Additional contacts provided via contactIds are added as regular parties.

ContractpostBffContractCreate

Parameters

JSON body

Request body

application/json

titlestringRequired

Contract title.

Length: 1–∞

ExampleService Agreement 2026

contentstringRequired

Contract body in Markdown format.

Example

# Service Agreement

This contract...

localestringRequired

Locale code for the contract language.

Examplescsende

contactIdsnumber[]Optional

Internal IDs of contacts to add as contract parties. The organisation contact is always added automatically as issuer.

templateIdnumberOptional

Template ID if the contract was created from a template.

Example5

validFromstringOptional

Validity start (ISO timestamp).

Example2026-01-01T00:00:00.000Z

validTostringOptional

Validity end (ISO timestamp).

Example2027-01-01T00:00:00.000Z

Response schema

1 status code documented

200Success

successbooleanRequired

Whether the contract was created successfully.

idstringRequired

External ID of the created contract.

Examplectr_abc123

Response example

application/json

{
  "success": false,
  "id": "ctr_abc123"
}

Request example

POST /bff/contract/create

post

curl -X POST "https://api.bizkithub.com/bff/contract/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "title": "Service Agreement 2026",
  "content": "# Service Agreement\n\nThis contract...",
  "locale": "cs",
  "contactIds": [
    1
  ],
  "templateId": 5,
  "validFrom": "2026-01-01T00:00:00.000Z",
  "validTo": "2027-01-01T00:00:00.000Z"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key