GraphQL Request

Executes a GraphQL request. Use this Connector to access GraphQL endpoints where a specialized connector is not available.

Revision History

1.0.0.0 Initial release.
2.0.0.0 complete overhaul.

Properties

Connection

Type: Connection Input
The Connection Property

Url
Type: String
Base URL for the GraphQL endpoint.

Headers
Type: Json
Optional JSON dictionary of headers to include with each request. Must be a JSON object with string values.

FileUrl
Type: String
Optional file upload endpoint for GraphQL multipart requests.

GetSchemaUrl
Type: String
Optional schema endpoint that returns metadata via HTTP GET without introspection.

SplitFileOperations
Type: Boolean
When true, splits query and variables into separate form fields for uploads.

AuthTestQuery
Type: Multiline Text
Query used to test authentication and connectivity (for example, { __typename }).

MaxDepth
Type: Integer
The maximum depth to use when generating samples from metadata.

AuthType
Type: List
Defines the authentication type. Options include:
None
Basic (requires BasicUsername and BasicPassword)
Bearer (requires BearerToken)
CustomBearer (requires CustomBearerHeaderName and CustomBearerToken)

BasicUsername
Type: String
Username for Basic authentication.

BasicPassword
Type: String
Password for Basic authentication.

BearerToken
Type: String
Bearer token for Authorization header.

CustomBearerHeaderName
Type: String
Custom header name for bearer-style tokens (for example, X-Shopify-Access-Token).

CustomBearerToken
Type: String
Token value for the custom bearer header.

Operation

Type: List Input
The Operation Property

Query
Mutation

Object

Type: String Input
The root GraphQL field to invoke.

SelectionSet

Type: Multiline Text Input
GraphQL selection set describing the fields to return.

ValidateSelectionSet

Type: Boolean Input
When true, validates the selection set against the schema.

Request

Type: Json Input
JSON body for mutation arguments.

CustomProperties

Type: Object
Additional arguments passed to the GraphQL operation as key/value pairs.

Response

Type: Json Output
The raw JSON response returned from the GraphQL endpoint.

Remarks

• Headers must be valid JSON objects with string values.
• Use AuthTestQuery to validate connectivity before running flows.
• If ValidateSelectionSet is disabled, schema mistakes will only surface at runtime.