ZuploZuplo
LoginStart for Free
  • Documentation
  • API Reference
Introduction
Getting Started
    Develop using the Portal
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth4 - Deploy5 - Dynamic Rate LimitingMCP - Quick start
    Develop Locally
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth
Concepts
Development
Policies
    Policy Catalog
    Authentication
    Authorization
    Security & Validation
    Metrics, Billing & Quotas
    Testing
    Request Modification
      Transform Request Body PolicyRemove Request Headers PolicyClear Request Headers PolicyChange Method PolicyForm Data to JSON PolicyRemove Query Parameters PolicyAdd or Set Request Headers PolicySet Body PolicyAdd or Set Query Parameters PolicyQuery Parameter to Header Policy
    Response Modification
    Upstream Authentication
    Archival
    GraphQL
    Other
    Guides
Handlers
API Keys
MCP Server
MCP Gateway
AI Gateway
Developer Portal
Monetization
Deploying & Source Control
Observability
Networking & Infrastructure
Account Management
Programming API
Build with AI
Zuplo CLI
Migration Guides
Platform LimitsSecuritySupportTrust & ComplianceChangelog
powered by Zudoku
Request Modification

Form Data to JSON Policy

Converts form data in the incoming request to JSON.

Configuration

The configuration shows how to configure the policy in the 'policies.json' document.

config/policies.json
{ "name": "my-formdata-to-json-inbound-policy", "policyType": "formdata-to-json-inbound", "handler": { "export": "FormDataToJsonInboundPolicy", "module": "$import(@zuplo/runtime)", "options": { "badRequestIfNotFormData": true } } }

Policy Configuration

  • name <string> - The name of your policy instance. This is used as a reference in your routes.
  • policyType <string> - The identifier of the policy. This is used by the Zuplo UI. Value should be formdata-to-json-inbound.
  • handler.export <string> - The name of the exported type. Value should be FormDataToJsonInboundPolicy.
  • handler.module <string> - The module containing the policy. Value should be $import(@zuplo/runtime).
  • handler.options <object> - The options for this policy. See Policy Options below.

Policy Options

The options for this policy are specified below. All properties are optional unless specifically marked as required.

  • badRequestIfNotFormData <boolean> - Should the policy return an error if the request is not of the type form data. Defaults to true.
  • optionalHoneypotName <string> - The name of the honeypot field. Used to provide basic spam filtering.

Using the Policy

Read more about how policies work

Edit this page
Last modified on May 29, 2026
Change Method PolicyRemove Query Parameters Policy
On this page
  • Configuration
    • Policy Configuration
    • Policy Options
  • Using the Policy
JSON