Skills/PDF/Fill a form

Fill a form

~1 credits / page (up to 50)

Populates a fillable PDF form by writing values into its named fields and returns the completed document. Provide the form and a mapping of field names to values; text fields, checkboxes, and numeric fields are all supported. The PDF must have real interactive form fields; flat or scanned forms are not supported.

Use when

You have a fillable PDF form and the values to put in its fields.

Not for

Flat PDFs with no form fields, or placing text at arbitrary coordinates.

Cost

~1 credits / page (up to 50)

Billed at 0.1 credits per page of the form.

Estimated; the actual charge depends on your input and is shown in the response.

What it accepts

Set these inside the intent when you run it.

source_pdfrequired

URL of the fillable PDF form.

fieldsrequired

A map of form field names to values. Text fields take strings, checkboxes take true/false, numeric fields take numbers. Field names must match the form's internal names exactly.

output_filenameoptional

Filename for the completed form PDF.

What you get back

The completed PDF form as a downloadable file.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the PDF skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/pdf/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"fill_form","source_pdf":"https://example.com/application.pdf","fields":"{\"first_name\": \"Jane\", \"last_name\": \"Smith\", \"agree_to_terms\": true}","output_filename":"filled-application.pdf"}}'

Example requests

  • Fill in this job application PDF with my details
  • Complete this W-9 form with the values I provide
  • Populate the fields in this contract template