How do I generate a headcount / hiring plan PDF from JSON?

Send a POST to /api/v1/generate with your API key, the template id and a JSON body shaped like the sample on this page; DocuJSON renders the headcount / hiring plan and returns the PDF. The same template is callable from the DocuJSON MCP server inside Claude, Cursor or your own agent.

What data does the headcount / hiring plan template need?

The JSON body has 7 top-level keys: period, currentHeadcount, plannedHeadcount, departments, pipeline, risks, budgetNotes.

Which designs does the headcount / hiring plan template come in?

Five, all free: base, ledger, instrument, rail, form. The same JSON body renders in all of them, so you can switch the design of your headcount / hiring plan without changing your integration.

Is the headcount / hiring plan template free?

Yes. Every template and every design is free, with a small DocuJSON watermark on the free plan. Pro removes the watermark, puts your logo where the DocuJSON mark sits in the headcount / hiring plan preview, and unlocks configurable variables and higher volume.

template · People · Letter portrait

headcount / hiring plan template: json in, branded pdf out

Hiring plan with open roles, recruiting funnel, budget, and risks.

use this template →generate it from code all templates

five designs, one json body

base · Fraunces + Inter Tightuse this design →

the docujson house design: serif titles, clean tables, KPI cards, navy accents.

what's inside

the sections of the document, in reading order.

01period
02current headcount
03planned headcount
04departments · 3 items
05pipeline
06risks · 2 items
07budget notes

the json body

7 keys

every key the document reads. send this shape, get the pdf.

periodstringperiod
currentHeadcountnumbercurrent headcount
plannedHeadcountnumberplanned headcount
departmentsarraydepartments · 3 items
pipelineobjectpipeline
risksarrayrisks · 2 items
budgetNotesstringbudget notes

built-in logic

This template's structure does the work: progress bars, kpi cards. Send the JSON; the engine lays it out in any of the five designs.

configurable outputs · pro

pro

one template. many outputs.

Set these once per template, in the workspace, no code. Every request then lays out by the rules you chose: the same data, a different document.

on every template

Signature blocks
Date format
Currency
Page orientation

configure it in the workspace →

the same data, three ways

signature blocks: off

page orientation: landscape

generate it from your code

01Pick a designChoose one of the five headcount / hiring plan designs; base and ledger are free.
02Send your JSONPOST a body shaped like the sample (period, currentHeadcount, plannedHeadcount, departments…) to /api/v1/generate with your API key, or call the template from the MCP server.
03Get the PDFDocuJSON renders the headcount / hiring plan with your logo and returns the PDF; the template id stays stable as you iterate.

Use this template in the builder, publish it, and you get a stable templateId for the API and the MCP server.

curl -X POST https://api.docujson.com/v1/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "templateId": "<your-template-id>", "data": { ... } }'

also: the `generate_pdf` tool on mcp.docujson.com, from Claude, Cursor or your own agent.

questions, answered

What is a headcount / hiring plan?: Hiring plan with open roles, recruiting funnel, budget, and risks.
How do I generate a headcount / hiring plan PDF from JSON?: Send a POST to /api/v1/generate with your API key, the template id and a JSON body shaped like the sample on this page; DocuJSON renders the headcount / hiring plan and returns the PDF. The same template is callable from the DocuJSON MCP server inside Claude, Cursor or your own agent.
What data does the headcount / hiring plan template need?: The JSON body has 7 top-level keys: period, currentHeadcount, plannedHeadcount, departments, pipeline, risks, budgetNotes.
Which designs does the headcount / hiring plan template come in?: Five, all free: base, ledger, instrument, rail, form. The same JSON body renders in all of them, so you can switch the design of your headcount / hiring plan without changing your integration.
Is the headcount / hiring plan template free?: Yes. Every template and every design is free, with a small DocuJSON watermark on the free plan. Pro removes the watermark, puts your logo where the DocuJSON mark sits in the headcount / hiring plan preview, and unlocks configurable variables and higher volume.

other people templates

all people →

Event Agenda / Workshop Schedule

Agenda with sessions, speakers, locations, times, and logistics.

People· 5 designs

Training Certificate

Completion certificate with recipient, course, date, issuer, and signatures.

People· 5 designs

Weekly Timesheet

One-page weekly record of time in, time out, breaks and total hours, with sign-off for payroll.

People· weekly· 5 designs

Pay Stub (Earnings Statement)

Per-pay-period statement of gross earnings, taxes and deductions, net pay, year-to-date totals and time-off balances.

People· biweekly· 5 designs

New Hire Onboarding Checklist

Phased checklist taking a new hire from pre-boarding to day 90, with owners, due dates and status.

People· per-event· 5 designs

Employee Performance Review

Structured review rating an employee's competencies, recording achievements and gaps, and agreeing goals for the next period, with sign-off.

People· quarterly· 5 designs

your headcount / hiring plan, from json, in one call.

free to start. you land on this template when you sign up.

use this template →

template · People · Letter portrait

headcount / hiring plan template: json in, branded pdf out

Hiring plan with open roles, recruiting funnel, budget, and risks.

use this template →generate it from code all templates

five designs, one json body

base · Fraunces + Inter Tightuse this design →

the docujson house design: serif titles, clean tables, KPI cards, navy accents.

what's inside

the sections of the document, in reading order.

01period
02current headcount
03planned headcount
04departments · 3 items
05pipeline
06risks · 2 items
07budget notes

the json body

7 keys

every key the document reads. send this shape, get the pdf.

periodstringperiod
currentHeadcountnumbercurrent headcount
plannedHeadcountnumberplanned headcount
departmentsarraydepartments · 3 items
pipelineobjectpipeline
risksarrayrisks · 2 items
budgetNotesstringbudget notes

built-in logic

This template's structure does the work: progress bars, kpi cards. Send the JSON; the engine lays it out in any of the five designs.

configurable outputs · pro

pro

one template. many outputs.

Set these once per template, in the workspace, no code. Every request then lays out by the rules you chose: the same data, a different document.

on every template

Signature blocks
Date format
Currency
Page orientation

configure it in the workspace →

the same data, three ways

signature blocks: off

page orientation: landscape

generate it from your code

01Pick a designChoose one of the five headcount / hiring plan designs; base and ledger are free.
02Send your JSONPOST a body shaped like the sample (period, currentHeadcount, plannedHeadcount, departments…) to /api/v1/generate with your API key, or call the template from the MCP server.
03Get the PDFDocuJSON renders the headcount / hiring plan with your logo and returns the PDF; the template id stays stable as you iterate.

Use this template in the builder, publish it, and you get a stable templateId for the API and the MCP server.

curl -X POST https://api.docujson.com/v1/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "templateId": "<your-template-id>", "data": { ... } }'

also: the `generate_pdf` tool on mcp.docujson.com, from Claude, Cursor or your own agent.

questions, answered

What is a headcount / hiring plan?: Hiring plan with open roles, recruiting funnel, budget, and risks.
How do I generate a headcount / hiring plan PDF from JSON?: Send a POST to /api/v1/generate with your API key, the template id and a JSON body shaped like the sample on this page; DocuJSON renders the headcount / hiring plan and returns the PDF. The same template is callable from the DocuJSON MCP server inside Claude, Cursor or your own agent.
What data does the headcount / hiring plan template need?: The JSON body has 7 top-level keys: period, currentHeadcount, plannedHeadcount, departments, pipeline, risks, budgetNotes.
Which designs does the headcount / hiring plan template come in?: Five, all free: base, ledger, instrument, rail, form. The same JSON body renders in all of them, so you can switch the design of your headcount / hiring plan without changing your integration.
Is the headcount / hiring plan template free?: Yes. Every template and every design is free, with a small DocuJSON watermark on the free plan. Pro removes the watermark, puts your logo where the DocuJSON mark sits in the headcount / hiring plan preview, and unlocks configurable variables and higher volume.

other people templates

all people →

Event Agenda / Workshop Schedule

Agenda with sessions, speakers, locations, times, and logistics.

People· 5 designs

Training Certificate

Completion certificate with recipient, course, date, issuer, and signatures.

People· 5 designs

Weekly Timesheet

One-page weekly record of time in, time out, breaks and total hours, with sign-off for payroll.

People· weekly· 5 designs

Pay Stub (Earnings Statement)

Per-pay-period statement of gross earnings, taxes and deductions, net pay, year-to-date totals and time-off balances.

People· biweekly· 5 designs

New Hire Onboarding Checklist

Phased checklist taking a new hire from pre-boarding to day 90, with owners, due dates and status.

People· per-event· 5 designs

Employee Performance Review

Structured review rating an employee's competencies, recording achievements and gaps, and agreeing goals for the next period, with sign-off.

People· quarterly· 5 designs

your headcount / hiring plan, from json, in one call.

free to start. you land on this template when you sign up.

use this template →