---
title: paymentCustomizationCreate - GraphQL Admin
description: Creates a payment customization.
api_version: 2024-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/paymentCustomizationCreate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/paymentCustomizationCreate.txt
---

# payment​Customization​Create

mutation

Requires `write_payment_customizations` access scope.

Creates a payment customization.

## Arguments

* payment​Customization

  [Payment​Customization​Input!](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/PaymentCustomizationInput)

  required

  The input data used to create the payment customization.

***

## Payment​Customization​Create​Payload returns

* payment​Customization

  [Payment​Customization](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/PaymentCustomization)

  Returns the created payment customization.

* user​Errors

  [\[Payment​Customization​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/PaymentCustomizationError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### paymentCustomizationCreate reference

## Mutation Reference

```graphql
mutation paymentCustomizationCreate($paymentCustomization: PaymentCustomizationInput!) {
  paymentCustomizationCreate(paymentCustomization: $paymentCustomization) {
    paymentCustomization {
      # PaymentCustomization fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "paymentCustomization": {
    "functionId": "<your-functionId>",
    "title": "<your-title>",
    "enabled": true,
    "metafields": [
      {
        "id": "gid://shopify/<objectName>/10079785100",
        "namespace": "<your-namespace>",
        "key": "<your-key>",
        "value": "<your-value>",
        "type": "<your-type>"
      }
    ]
  }
}
```