---
title: delegateAccessTokenCreate - GraphQL Admin
description: >-
  Creates a
  [`DelegateAccessToken`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DelegateAccessToken)
  with a subset of the parent token's permissions.


  Delegate access tokens enable secure permission delegation to subsystems or
  services that need limited access to shop resources. Each token inherits only
  the scopes you specify, ensuring subsystems operate with minimal required
  permissions rather than full app access.


  Learn more about [delegating access tokens to
  subsystems](https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/use-delegate-tokens).
api_version: 2025-01
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/delegateAccessTokenCreate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/delegateAccessTokenCreate.md
---

# delegate​Access​Token​Create

mutation

Creates a [`DelegateAccessToken`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DelegateAccessToken) with a subset of the parent token's permissions.

Delegate access tokens enable secure permission delegation to subsystems or services that need limited access to shop resources. Each token inherits only the scopes you specify, ensuring subsystems operate with minimal required permissions rather than full app access.

Learn more about [delegating access tokens to subsystems](https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/use-delegate-tokens).

## Arguments

* input

  [Delegate​Access​Token​Input!](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/DelegateAccessTokenInput)

  required

  The input fields for creating a delegate access token.

***

## Delegate​Access​Token​Create​Payload returns

* delegate​Access​Token

  [Delegate​Access​Token](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/DelegateAccessToken)

  The delegate access token.

* shop

  [Shop!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Shop)

  non-null

  The user's shop.

* user​Errors

  [\[Delegate​Access​Token​Create​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/DelegateAccessTokenCreateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### delegateAccessTokenCreate reference

## Mutation Reference

```graphql
mutation delegateAccessTokenCreate($input: DelegateAccessTokenInput!) {
  delegateAccessTokenCreate(input: $input) {
    delegateAccessToken {
      # DelegateAccessToken fields
    }
    shop {
      # Shop fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{
  "input": {
    "delegateAccessScope": [
      "<your-delegateAccessScope>"
    ],
    "expiresIn": 1
  }
}
```

##### Schema

```graphql
input DelegateAccessTokenInput {
  delegateAccessScope: [String!]!
  expiresIn: Int
}
```