Connections - Encoding types
Overview
When defining an action for a custom connection, these types of encoding types are accepted:
- No encoding
- Full encoding (RFC 3986)
- UTF-8 encoding
By default, Full encoding (RFC 3986) is being applied to all custom actions when creating.
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 on how the encoding is applied:
URL path example, with a dynamic and a static parameter:
Input | Output |
---|---|
/contacts?phone={{phone}}&number=+123445&test=á$+.@ Dynamic query parameter: phone = +9112233 | /contacts?phone=+9112233&number=+123445&test=%C3%A1$+.@ |
Character Encoding:
Input Character | Output Character |
---|---|
: / ? # [ ] @ ! $ & ' ( ) * + , ; = | Unchanged (reserved) |
Alphanumeric characters, such as 1 or a | Unchanged |
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:
Input | Output |
---|---|
/contacts?phone={{phone}}&number=+123445 Dynamic query parameter: phone = +9112233 | /contacts?phone=%2B9112233&number=+123445 |
Character Encoding:
Input | Output |
---|---|
%2B91XXXXXXXX | %252B91XXXXXXXX |
+91XXXXXXXX | %2B91XXXXXXXX |
< value > | %3Cvalue%3E |
+351 9XXXXXXX | %2B351+9XXXXXXX |
João | Jo%C3%A3o |
name:alcides&age:30 | name%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.
Updated 6 days ago