Skip to main content
New to Corsair? See API access, authentication, and error handling.

Account

getInfo

account.getInfo Read the account name, credit usage and template count against their limits Risk: read
Input: empty object Output

Editor

createSession

editor.createSession Create a signed URL that lets its bearer edit a template in the embedded designer; the URL is a credential Risk: write
Input The returned URL is a signed token that lets its bearer edit the template, so treat it as a credential and deactivate it when done. Output

deactivateSession

editor.deactivateSession Revoke an editor session so its URL stops working Risk: write
Input Output

Pdf

addText

pdf.addText Draw text such as page numbers or headers on chosen pages of a PDF and return a new file Risk: write
Input
Output

addWatermark

pdf.addWatermark Stamp a text watermark on every page of a PDF and return a new file Risk: write
Input Output

create

pdf.create Generate a PDF from a template and JSON data, synchronously; consumes one credit per PDF Risk: write
Input A synchronous call can take up to 100 seconds, so the plugin waits 120 seconds before timing out. Each call spends one credit. Output

createAsync

pdf.createAsync Queue a PDF generation and return at once with a transaction reference, delivering the file to a webhook URL; consumes one credit per PDF Risk: write
Input CraftMyPDF calls webhook_url with a GET once the file is ready, appending file (the PDF URL), transaction_ref, status, message and details as query parameters. The webhook is the only place the file URL arrives. transactions.list shows the job and its status, but no file URL, so pass webhook_url if you need the file. Output

createImage

pdf.createImage Render a template to a JPEG or PNG image instead of a PDF; consumes one credit per image Risk: write
Input Output

createMerge

pdf.createMerge Render several templates, each with its own data, into one combined PDF; consumes one credit per template Risk: write
Input
Output

createParallel

pdf.createParallel Generate a batch of PDFs in one request, each from its own template data, optionally merging them into a single file; consumes one credit per PDF Risk: write
Input Each request entry carries its own template data. Set merge to also receive one combined PDF.
Output

getInfo

pdf.getInfo Read the page count and document properties of a PDF at a URL Risk: read
Input Output

merge

pdf.merge Merge several PDFs fetched by URL into one file Risk: write
Input Output

updateFields

pdf.updateFields Fill the form fields of a PDF and optionally make them read-only, returning a new file Risk: write
Input CraftMyPDF answers success even when a field does not exist in the document and reports the failure only in field_statuses. The plugin also returns the failures as failed_fields, so check it is empty before treating the form as filled.
Output

Templates

createFrom

templates.createFrom Create a new template by copying an existing one Risk: write
Input Output

delete

templates.delete Permanently delete a template Risk: destructive · Irreversible
Input Output

get

templates.get Read one template, including its body and sample JSON data Risk: read
Input Output

list

templates.list List the templates on the account with the ids generation calls need Risk: read
Input CraftMyPDF reports no total, so next_offset is present only when the page came back full. Pass it as offset to read the next page. Output

listVersions

templates.listVersions List the saved versions of a template Risk: read
Input Output

queryUsage

templates.queryUsage Report how many PDFs and credits the given templates used in a date range Risk: read
Input Output

retainVersions

templates.retainVersions Mark template versions to protect from automatic cleanup, or release the ones already kept; a released version can be cleaned up later Risk: write
Input Output

transfer

templates.transfer Move a template to another team, after which this account no longer owns it Risk: write
Input Output

update

templates.update Change a template’s name, sample JSON data or body; the body is what the template renders Risk: write
Input Output

Transactions

list

transactions.list List past generations with their status, credit cost and file size Risk: read
Input next_offset is present only when the page came back full. Output