stagedUploadsCreate

Get signed upload URLs for pushing files (images, videos, JSONL for bulk mutations) to Shopify's storage before referencing them.

Use it in a workflow

Add a step and choose the Shopify connector.
Pick the stagedUploadsCreate action (under Staged).
Fill in the fields below, then reference the result from later steps as {{stageduploadscreate.response.data}}.

Query

This is the mutation the action sends by default. Edit it in the step's Query field to change which fields come back.

graphql

mutation StagedUploadsCreate($input: [StagedUploadInput!]!) {
  stagedUploadsCreate(input: $input) {
    stagedTargets {
      parameters {
        name
        value
      }
      resourceUrl
      url
    }
    userErrors {
      field
      message
    }
  }
}

Variables

Pass these as a JSON object in the step's Variables field.

inputarray<object>required

The information required to generate staged upload targets.

resourcestringrequired

One ofCOLLECTION_IMAGEFILEIMAGEMODEL_3DPRODUCT_IMAGESHOP_IMAGEVIDEOBULK_MUTATION_VARIABLESRETURN_LABELURL_REDIRECT_IMPORTDISPUTE_FILE_UPLOAD

filenamestringrequired

mimeTypestringrequired

httpMethodstring

One ofPOSTPUT

fileSizestring

json

{
  "input": [
    {
      "resource": "COLLECTION_IMAGE",
      "filename": "string",
      "mimeType": "string",
      "httpMethod": "POST",
      "fileSize": "string"
    }
  ]
}

Response

Read the result with {{stageduploadscreate.response.data.data.stagedUploadsCreate}}. If the API returns errors, the step fails and they are at {{stageduploadscreate.response.data.errors}}.

stagedTargetsarray<object>

parametersobject

resourceUrlobject

urlobject

userErrorsarray<object>

fieldobject

messageobject

Need more? See the Shopify guide for connection setup and behaviour shared by every action.

Was this page helpful?