Fillout

Interact with Fillout through its documented REST API from OpenPets-compatible AI coding agents.

Setup

1. Open the Fillout REST API settings page in your Fillout account.
2. Create or copy an API key.
3. Add it to your environment:

FILLOUT_API_KEY=your_api_key_here

The default API base URL is:

https://api.fillout.com/v1/api

Override it only if your Fillout workspace provides a different endpoint:

FILLOUT_HOST=https://eu-api.fillout.com/v1/api

Tools

• fillout-test-connection - verify credentials and list a small sample of forms.
• fillout-get-forms - list forms available to the API key.
• fillout-get-form-metadata - retrieve form metadata, including questions, calculations, URL parameters, scheduling, payments, and quiz fields.
• fillout-get-all-submissions - list submissions with pagination, date, status, search, preview, edit-link, and sort filters.
• fillout-get-submission-by-id - retrieve one submission by ID.
• fillout-delete-submission-by-id - delete one submission by ID.
• fillout-create-webhook - create a form webhook.
• fillout-remove-webhook - remove a webhook by ID.
• fillout-create-submissions - import up to 10 submissions from a JSON string payload.

Read-Only Mode

Set read-only mode to hide mutating tools:

FILLOUT_READ_ONLY=true

or:

pets read-only fillout on

Testing

pets validate ./pets/fillout
pets build fillout
cd pets/fillout
pets exec fillout-test-connection --plugin ./index.ts --args '{}' --json

When FILLOUT_API_KEY is not set, the plugin intentionally returns only the test-connection tool with setup guidance.