Create a document

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

Headers

  • X-PLANNR-ACCOUNT-UUID string
application/json

Body Required

  • name string Required

    The name of the document.

  • client_uuids array[string] Required

    An array containing the client uuids that should be sent the document when it is built.

  • template_uuid string

    The UUID of the document template you want to be used with this document. You must not provide the sfdt or docx fields when creating from a template.

  • known_dependants array[string]

    Optional: The document variable dependants. Used to swap variables out for real data.

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.

    • status string

      The status of the document.

    • last_publishing_error string

      The last error that occured during publishing.

    • required_dependants object

      The required dependant variables of the document.

      Hide required_dependants attribute Show required_dependants attribute object
      • client-1 string
    • known_dependants object

      The dependants submitted to the document previously.

      Hide known_dependants attribute Show known_dependants attribute object
      • client-1 string
    • 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 document. This is intended for the user to preview the document before opening it. You can access this data via the API using the route in /api/v1.
POST /api/v1/document 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/document' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"name":"Client Service Agreement","client_uuids":["7a73d149-72dc-4986-a698-07072fb1ee38","da5416dd-db53-4c16-be2a-005b54d19e23"],"template_uuid":"72930596-f058-4545-8486-eb797451662d","known_dependants":[{"client-1":"f4cea995-41ab-47f7-91e8-efe75f5ecb07"}]}'
Request examples 
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Client Service Agreement",
  "client_uuids": [
    "7a73d149-72dc-4986-a698-07072fb1ee38",
    "da5416dd-db53-4c16-be2a-005b54d19e23"
  ],
  "template_uuid": "72930596-f058-4545-8486-eb797451662d",
  "known_dependants": [
    {
      "client-1": "f4cea995-41ab-47f7-91e8-efe75f5ecb07"
    }
  ]
}
Response examples (201) 
{
  "name": "Welcome Template",
  "uuid": "f8a50458-36fb-4dbb-8f13-a3e28a3a9021",
  "status": "published",
  "version": 3,
  "created_at": "2025-08-07T13:41:43+01:00",
  "updated_at": "2025-08-07T13:41:43+01:00",
  "public_pdf_url": "https://api.plannrcrm.com/document/e522c50d-dfba-4810-ac6c-9a33b8edec45/content/pdf?plannr_account_uuid=7788b669-0ae2-448c-b475-95a5f77cfffa",
  "public_docx_url": "https://api.plannrcrm.com/document/3ab2992b-9a5b-40fa-b88b-372e5d7052bf/content/docx?plannr_account_uuid=9cb2c11f-3615-41ae-a6bc-e213ebf5fab1",
  "public_sfdt_url": "https://api.plannrcrm.com/document/54482321-34c2-4c29-94f6-3f6522229c61/content/sfdt?plannr_account_uuid=a806aaa5-f9ae-4e84-b036-06e3038c534f",
  "known_dependants": {
    "client-1": "7f73fb8c-983a-412f-8f6e-28398ea62cd2"
  },
  "public_preview_url": "https://api.plannrcrm.com/document/dd87aba9-09f8-489f-89db-06299f8a95fa/content/preview?plannr_account_uuid=99913385-99da-4419-b26c-d7938c82004a",
  "required_dependants": {
    "client-1": "client"
  },
  "last_publishing_error": "There was an error converting this file to PDF. Please try again later."
}