ZuploZuplo
LoginStart for Free
  • Documentation
  • API Reference
Introduction
Getting Started
    Develop on the web portal
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth4 - Deploy5 - Dynamic Rate LimitingDynamic MCP Server - Quickstart
    Develop locally with the CLI
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth4 - Deploy5 - Dynamic Rate LimitingDynamic MCP Server - Quickstart
Concepts
Development
Policies
    Policy Catalog
    Authentication
    Authorization
    MCP Authorization
    Security & Validation
    Metrics, Billing & Quotas
    Testing
    Request Modification
      Transform Request BodyRemove Request HeadersClear Request HeadersChange MethodForm Data to JSONRemove Query ParametersAdd or Set Request HeadersSet BodyAdd or Set Query ParametersQuery Parameter to Header
    Response Modification
    Upstream Authentication
    Archival
    GraphQL
    Other
    Guides
Handlers
API Keys
Rate Limiting
MCP Server
MCP Gateway
AI Gateway
Developer Portal
Monetization
Deploying & Source Control
Analytics
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 June 15, 2026
Change MethodRemove Query Parameters
On this page
  • Configuration
    • Policy Configuration
    • Policy Options
  • Using the Policy
JSON