upload_file

Field	Description	Type	Required
`additionalFields`	Additional form fields to include in the multipart request	object[]	No
`args`	Additional request parameters (query params, headers)	object[]	No
`authorization`	Overrides the connector’s default authentication for this request.	union	No
`baseUrl`	Overrides the connector’s base URL for the upload.	string	No
`customErrors`	Remaps matching provider error responses to different statuses or messages.	object[]	No
`file`	The file to upload	object	Yes
`method`	HTTP method to use for the upload. Allowed: `get`, `post`, `put`, `delete`, `patch` Default: `post`	enum	Yes
`response`	Controls how the raw response is parsed into step output data.	object	No
`url`	Upload endpoint path appended to the base URL.	string	Yes

additionalFields

Additional form fields to include in the multipart request

Field	Description	Type	Required
`condition`	A JEXL expression that includes the field only when it evaluates true.	string	No
`contentType`	The MIME type for this form field (e.g., “application/json”)	string	No
`name`	Name of the form field.	string	Yes
`value`	Value of the form field.	any	Yes

args

Additional request parameters (query params, headers)

Field	Description	Type	Required
`arrayFormat`	How array values are serialized in the query string: repeat, brackets, comma, or stringify. Allowed: `repeat`, `brackets`, `comma`, `stringify`	enum	No
`condition`	A JEXL expression that includes the parameter only when it evaluates true.	string	No
`in`	Where to send the parameter: query, body, or headers. Allowed: `query`, `body`, `headers`	enum	Yes
`name`	Name of the request parameter.	string	Yes
`spread`	Merges the value’s object entries into the target location instead of setting a single named field.	boolean	No
`value`	Value of the parameter. Supports expressions.	any	Yes

authorization

Overrides the connector’s default authentication for this request.

none
basic
bearer
oauth2

Field	Description	Type	Required
`redirectUri`	OAuth callback URL carried as connect-time metadata. Not used when authorizing requests.	string	No
`signing`	Optional request signing applied to outgoing requests. Selects AWS SigV4 or HMAC signing.	union	No
`type`	Sends requests without an authorization header.	string	Yes

authorization.none.signing

Optional request signing applied to outgoing requests. Selects AWS SigV4 or HMAC signing.

aws4
hmac

Field	Description	Type	Required
`region`	AWS region used in the signing credential scope. Falls back to the credential region or `us-east-1` when omitted.	string	No
`service`	AWS service name used in the signing credential scope. For example `s3` or `execute-api`.	string	Yes
`strategy`	Signs requests with AWS Signature Version 4.	string	Yes

Field	Description	Type	Required
`algorithm`	Hash algorithm for the HMAC signature. Defaults to `sha256`. Allowed: `sha1`, `sha256`, `sha512`	enum	No
`dateFormat`	Timestamp format used in the signed string. Either `iso8601` (default) or `rfc2822`. Allowed: `iso8601`, `rfc2822`	enum	No
`headerName`	Header the signature is written into. Defaults to `X-Signature`.	string	No
`includeBodyHash`	Hash the request body into the signed string, defaulting to `true`. When `false`, form-urlencoded body params are folded into the canonical string instead.	boolean	No
`includeHost`	Include the request hostname in the signed canonical string. Defaults to `false`.	boolean	No
`outputFormat`	Where the signature is emitted. `header` writes a signature header and `basic` writes an HTTP Basic `Authorization` header. Allowed: `header`, `basic`	enum	No
`prefix`	Prefix prepended to the signature value in the header. Defaults to `hmac-<algorithm>`.	string	No
`strategy`	Signs requests with an HMAC signature over a canonical request string.	string	Yes
`username`	Username paired with the signature when `outputFormat` is `basic`.	string	No

Field	Description	Type	Required
`encoding`	Encoding applied to the `username:password` pair. Defaults to `base64`.	string	No
`password`	Password for HTTP Basic authentication.	string	No
`redirectUri`	OAuth callback URL carried as connect-time metadata. Not used when authorizing requests.	string	No
`type`	Configures HTTP Basic authentication.	string	Yes
`username`	Username for HTTP Basic authentication.	string	No

Field	Description	Type	Required
`includeBearer`	Prefix the token with `Bearer` in the `Authorization` header. Defaults to `true`. Default: `true`	boolean	Yes
`redirectUri`	OAuth callback URL carried as connect-time metadata. Not used when authorizing requests.	string	No
`token`	Token sent on each request. Supports expressions.	string	Yes
`type`	Configures bearer token authentication.	string	Yes

Field	Description	Type	Required
`additionalTokenFields`	Extra credential fields to read from the token endpoint response. Each key is a credential name and each value an expression.	object	No
`authorizationParams`	Extra query parameters appended to the authorization URL. Values support expressions.	object	No
`authorizationUrl`	Provider authorization endpoint where the user grants access.	string	No
`callbackParams`	Maps OAuth callback query parameter names to the credential keys their values are stored under. Cannot target reserved credential keys.	object	No
`customHeaders`	Additional HTTP headers sent with token endpoint requests.	object	No
`includeBearer`	Prefix the token with `Bearer` in the `Authorization` header. Defaults to `true`. Default: `true`	boolean	Yes
`issuer`	OpenID Connect issuer identifier for the provider.	string	No
`pkce`	Enable PKCE for the authorization code flow.	boolean	No
`redirectUri`	Overrides the OAuth callback URL. The computed callback URL can be seen on the connector profile.	string	No
`scopeDelimiter`	Delimiter used to separate scopes when requesting authorization.	string	No
`scopes`	OAuth scopes requested during authorization.	string	No
`token`	Expression that resolves the access token sent on each request.	string	Yes
`tokenExpiresIn`	Access token lifetime in seconds.	number	No
`tokenParams`	Extra parameters sent to the token endpoint. Values support expressions.	object	No
`tokenRefreshExpiresIn`	Refresh token lifetime in seconds.	number	No
`tokenResponse`	Adjusts how a non-standard token endpoint response is parsed.	object	No
`tokenUrl`	Provider token endpoint used to exchange the authorization code and to refresh tokens.	string	No
`type`	Configures OAuth 2.0 authentication.	string	Yes

authorization.oauth2.tokenResponse

Adjusts how a non-standard token endpoint response is parsed.

Field	Description	Type	Required
`acceptTokenTypes`	Allowlist of `token_type` values to accept from the token endpoint beyond `Bearer` and `DPoP`. Matched case-insensitively.	string[]	No
`accessToken`	Expression locating the access token in the token endpoint response. Takes precedence over the standard `access_token` field when it resolves to a non-empty string.	string	No
`refreshToken`	Expression locating the refresh token in the token endpoint response. Takes precedence over the standard `refresh_token` field when it resolves to a non-empty string.	string	No

customErrors

Remaps provider error responses to different statuses or messages. Useful for GraphQL APIs that return errors with a 200 status, normalizing provider-specific error formats, and giving AI agents clearer error messages.

Field	Description	Type	Required
`condition`	A JEXL expression that applies the remap only when it evaluates true.	string	No
`message`	Error message to return in place of the provider’s.	string	No
`receivedStatus`	Provider HTTP status code to match.	number	Yes
`targetStatus`	HTTP status code to return in place of the matched one.	number	Yes

file

The file to upload

Field	Description	Type	Required
`content`	The file content as base64 encoded string	string	Yes
`contentType`	The MIME type of the file (e.g., “image/png”, “application/pdf”)	string	No
`fieldName`	The form field name for the file	string	Yes
`filename`	The filename to use in the upload	string	Yes

response

Controls how the raw response is parsed into step output data.

Field	Description	Type	Required
`collection`	Whether to treat the response payload as a collection of records to index.	boolean	No
`dataKey`	Top-level response key holding the records to extract.	string	No
`indexField`	Field used to key results when returning an indexed map.	string	No

Input

Output

​Input

​Output

Input

Output