Body
Last updated
Last updated
The body tab is primarily used for creating or updating resources (i.e. for POST, PUT, PATCH and DELETE requests).
Any parameters added here are passed in the endpoint request body. You can define default body parameters, and optional body parameters:
The body tab is split into upper and lower panels:
If you have parameters that must always be passed in the endpoint request body, add them to the required body parameters panel. Default parameters are passed straight into requests - users are never asked to provide values for these.
Use this option to pass static content or an incoming payload into the request body. Select the raw option and choose the required data type:
...then (if required) use the editor provided to add the required data:
Select the form option to add data as key pairs:
Select the text option and add the required text content to the body content field:
Set this option to none if no body content is expected.
It's important to note that this option is ignored if data is found in the body. This handles scenarios where body content isn't typically expected so body format is set to none, but later (for example) a custom script is introduced which adds a payload to the body.
It's important to note that when a runs and reaches a destination connection (i.e. a associated with a POST, PUT, PATCH and DELETE endpoint), the payload generated from previous steps is automatically added to the body of that request. You do not need to add anything to the endpoint body tab for this to happen - it's automatic.
When an is applied for an endpoint, any header and body parameters specified for the authentication method are also sent in the endpoint requests - you don't need to add them twice.
Required body content can be , or added as , , or data:
If you use form data to send data as files, please be aware that cannot be used.
In order to send an empty body, no Content-Type header should be set. If a Content-Type header IS set (within options), then 'none' will still fall back to sending the default payload (the output of the previous shape).
If you have parameters that you want to expose to users when they configure a to use this endpoint in and then pass provided values into the endpoint request body, add them to the lower panel:
Body filters are available for your users to update with their own required values, in process flows. These work in exactly the same way , except any values provided by users (via the in ) are passed into the request body, rather than being added as URL queries.
Techniques for adding header parameters are the same as all other types of parameters that you may encounter in the connector builder. For information about these options please see the page.
