Encoding Types

Overview

When defining an action for a custom connection, these encoding types are accepted:

  • No encoding
  • Full encoding (RFC 3986)
  • UTF-8 encoding

By default, Full encoding (RFC 3986) is applied to all custom actions when creating.

Note: A trailing slash at the end of the relative path is removed by default. To preserve a trailing slash exactly as configured, enable the Preserve trailing slash option in the action's URL Settings.

No encoding

This option allows you to send query parameters without applying any additional encoding. Special characters and symbols are preserved exactly as provided.

However, for security and compatibility reasons, a syntactically valid URI is still required. This means certain reserved characters (such as #, ?, &, etc.) may still require manual encoding depending on their placement, especially if they interfere with URI parsing.

This mode should only be used when the receiving system expects and can correctly interpret raw or pre-encoded query strings.

Full Encoding (RFC 3986)

This option encodes the URL following the standards outlined in RFC 3986, which defines URL syntax. Below are examples of how the encoding is applied:

URL path example, with a dynamic and a static parameter:

InputOutput

/contacts?phone={{phone}}#ber=+123445&test=á$+.@

Dynamic query parameter:
phone = +9112233

/contacts?phone=+9112233#ber=+123445&test=%C3%A1$+.@

Character Encoding:

Input CharacterOutput Character
: / ? # [ ] @ ! $ & ' ( ) * + , ; =Unchanged (reserved)
Alphanumeric characters, such as 1 or aUnchanged
Non-alphanumeric characters, such as á or <Encoded (e.g.: á -> %C3%A1)
Space%20
%%25

UTF-8 Encoding

This encoding type encodes all dynamic query parameters, replacing all characters with UTF-8. It is typically used for handling special characters, internationalization, and extended character sets.

URL path example, with a dynamic and a static parameter:

InputOutput

/contacts?phone={{phone}}#ber=+123445

Dynamic query parameter:
phone = +9112233

/contacts?phone=%2B9112233#ber=+123445

Character Encoding:

InputOutput
%2B91XXXXXXXX%252B91XXXXXXXX
+91XXXXXXXX%2B91XXXXXXXX
< value >%3Cvalue%3E
+351 9XXXXXXX%2B351+9XXXXXXX
JoãoJo%C3%A3o
name:alcides&age:30name%3Aalcides%26age%3A30
field like '%2B'field+like+%27%252B%27

🚧

Troubleshooting

If you have questions or technical issues, please open a ticket using this form.