Create a document template

POST /api/v1/document-template
Personal access token & O auth2

Headers

application/json

Body Required

  • name string Required

    The name of the document template.

Responses

  • 201 application/json
    Hide response attributes Show response attributes object
    • uuid string

      The UUID of the resource.

    • created_at string

      The timestamp of when the resource was created.

    • updated_at string

      The timestamp of when the resource was updated.

    • version integer

      The document builder version. Used for internal purposes only. Defaults to 3

    • name string

      The name of the document template.

    • required_dependants object

      The required dependant variables of the document template.

    • public_docx_url string

      The download URL of the DOCX content. This is intended for the user to download if they are signed into Plannr. You can access this data via the API using the route in /api/v1.

    • public_sfdt_url string

      The download URL of the SFDT (SyncFusion) content. This is intended for the user to download if they are signed into Plannr. You can access this data via the API using the route in /api/v1.

    • public_pdf_url string

      The download URL of the PDF content. This is intended for the user to download if they are signed into Plannr. You can access this data via the API using the route in /api/v1.

    • public_preview_url string

      The image preview URL of the template. This is intended for the user to preview the template before opening it. You can access this data via the API using the route in /api/v1.
POST /api/v1/document-template 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/document-template' \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"name":"Client Service Agreement"}'
Request examples 
# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Client Service Agreement"
}
Response examples (201) 
{
  "name": "Welcome Template",
  "uuid": "8a31d75f-2e42-4919-b585-a8150a09a8dd",
  "version": 3,
  "created_at": "2025-06-13T16:58:58+01:00",
  "updated_at": "2025-06-13T16:58:58+01:00",
  "public_pdf_url": "https://plannr.valet/document-template/a552af0d-f0ad-41f3-a790-00f29865f7b3/content/pdf?plannr_account_uuid=7a596646-e6a0-487c-937b-31b8d98b5e05",
  "public_docx_url": "https://plannr.valet/document-template/1b2b2375-d4f4-4493-9863-91d1f52a4138/content/docx?plannr_account_uuid=a63131f4-a5aa-45a8-9889-2fb5c6391e6f",
  "public_sfdt_url": "https://plannr.valet/document-template/e7b055d4-c38a-460e-b0a6-7077dd579873/content/sfdt?plannr_account_uuid=fde91fb3-99ce-42ff-b2fa-c41f0a164189",
  "public_preview_url": "https://plannr.valet/document-template/9b724232-b4bf-4e94-b483-94f0ce89ca0c/content/preview?plannr_account_uuid=b911cf08-49b8-4fb7-945d-0394bcc387f6",
  "required_dependants": {
    "client-1": "client"
  }
}