Method
POST /v1/contract-templates
Body Parameters
Show Translation object
Show Translation object
Headers
string
Bearer token (requires
contract-templates:write).string
application/jsonRequest Example
curl -X POST "https://api.voyantcloud.com/v1/contract-templates" \
-H "Authorization: Bearer $VOYANT_API_KEY" \
-H "content-type: application/json" \
-d '{
"name": "Customer Master Agreement",
"type": "customer",
"description": "Standard customer contract",
"templateJson": {
"sections": [
{
"type": "paragraph",
"text": "This Agreement is made between {{seller.name}} and {{buyer.name}}."
}
]
},
"translation": {
"locale": "fr",
"bodyHtml": "<p>Ce contrat lie {{seller.name}} à {{buyer.name}}.</p>",
"variables": {
"seller.name": "Raison sociale du vendeur",
"buyer.name": "Raison sociale du client"
}
}
}'
const res = await fetch("https://api.voyantcloud.com/v1/contract-templates", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOYANT_API_KEY}`,
"content-type": "application/json",
},
body: JSON.stringify({
name: "Supplier Agreement",
type: "supplier",
templateJson: { placeholders: ["supplier.name", "contract.startDate"] },
active: false,
}),
})
const payload = await res.json()
import os, requests
payload = {
"name": "Partner NDA",
"description": "Mutual NDA for channel partners",
"templateJson": {"sections": []},
"translation": {
"locale": "en",
"name": "Partner NDA",
"bodyHtml": "<p>Confidentiality terms between {{partner.name}} and {{voyant.name}}.</p>"
}
}
resp = requests.post(
"https://api.voyantcloud.com/v1/contract-templates",
headers={
"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}",
"content-type": "application/json",
},
json=payload,
)
template = resp.json()
Response
{
"template": {
"id": "ct_01J0BE7Z3S494F9D4T3E2QJ0XR",
"workspaceId": "ws_01HZYPM2QF2R8X9SZQ0J9SYBCN",
"name": "Customer Master Agreement",
"type": "customer",
"description": "Standard customer contract",
"templateJson": {
"sections": [
{
"type": "paragraph",
"text": "This Agreement is made between {{seller.name}} and {{buyer.name}}."
}
]
},
"active": true,
"createdBy": null,
"createdAt": "2025-01-10T11:08:44.000Z",
"updatedAt": "2025-01-10T11:08:44.000Z"
}
}
If you supply
translation, only the specified locale is stored. Use the update endpoint to add additional locales later.