Send an x-www-form-urlencoded body#

The x-www-form-urlencoded body type sends the body as one encoded string of key and value pairs. It suits classic form posts and token endpoints. This page covers the table and what goes on the wire.

The key and value table#

Each row has a tickbox, a Key, a Value, and a delete button. There is no Type column, so every row is text. The empty row at the bottom adds the next pair: type a key, then press Enter or select the plus button.

A row that you turn off stays in the table but stays out of the body.

What goes on the wire#

The app percent-encodes the ticked rows and joins them with &, the same way it builds a query string:

key1=value%201&key2=value%202

The app still sends an empty value as key=.

The Content-Type it sets#

When this type is active, the app sets the request Content-Type to application/x-www-form-urlencoded for you.

Choose between this and form-data#

Use x-www-form-urlencoded for a plain set of key and value pairs, such as an HTML form post or an OAuth token exchange. Use form-data instead when you need to attach a file.