---
title: bulkOperationRunMutation - GraphQL Admin
description: >-
  Creates and runs a bulk operation mutation.


  To learn how to bulk import large volumes of data asynchronously, refer to the

  [bulk import data
  guide](https://shopify.dev/api/usage/bulk-operations/imports).
api_version: 2025-07
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/bulkOperationRunMutation
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/bulkOperationRunMutation.md
---

# bulk​Operation​Run​Mutation

mutation

Creates and runs a bulk operation mutation.

To learn how to bulk import large volumes of data asynchronously, refer to the [bulk import data guide](https://shopify.dev/api/usage/bulk-operations/imports).

## Arguments

* client​Identifier

  [String](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String)

  An optional identifier which may be used for querying.

* group​Objects

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/Boolean)

  requiredDefault:true

  Whether to group objects under their corresponding parent objects in the JSONL output. Grouping is costly, causes bulk operations to take longer to complete, and increases the chances of failures such as timeouts.

* mutation

  [String!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String)

  required

  The mutation to be executed in bulk.

* staged​Upload​Path

  [String!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String)

  required

  The staged upload path of the file containing mutation variables.

***

## Bulk​Operation​Run​Mutation​Payload returns

* bulk​Operation

  [Bulk​Operation](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/BulkOperation)

  The newly created bulk operation.

* user​Errors

  [\[Bulk​Mutation​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/BulkMutationUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### bulkOperationRunMutation reference

## Mutation Reference

```graphql
mutation bulkOperationRunMutation($mutation: String!, $stagedUploadPath: String!, $groupObjects: Boolean!, $clientIdentifier: String) {
  bulkOperationRunMutation(mutation: $mutation, stagedUploadPath: $stagedUploadPath, groupObjects: $groupObjects, clientIdentifier: $clientIdentifier) {
    bulkOperation {
      # BulkOperation fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "mutation": "<your-mutation>",
  "stagedUploadPath": "<your-stagedUploadPath>",
  "groupObjects": true,
  "clientIdentifier": "<your-clientIdentifier>"
}
```

##### Variables

```
{
  "mutation": "<your-mutation>",
  "stagedUploadPath": "<your-stagedUploadPath>",
  "groupObjects": true,
  "clientIdentifier": "<your-clientIdentifier>"
}
```