# updateCustomFields

Mutation · GraphQL API

Update custom fields on a transaction or refund. Custom fields are [defined in the Control Panel](https://articles.braintreepayments.com/control-panel/custom-fields#store-and-pass-back-fields).

## Authentication

- SERVER

## Input

- `input` (`UpdateCustomFieldsInput!`) — required

## Returns [UpdateCustomFieldsPayload](/braintree/graphql/reference/types/update-custom-fields-payload)

Top-level output field from updating custom fields for a specific transaction or a refund.

### Returned fields

- `clientMutationId` (`String`): An identifier used to reconcile requests and responses. 255 characters maximum.
- `customFields` (`[CustomField!]`): A list of all custom fields on the updated transaction or refund. Custom fields are [defined in the Control Panel](https://articles.braintreepayments.com/control-panel/custom-fields#store-and-pass-back-fields).

## Examples

### Update custom fields

Input for creating or updating custom fields on a transaction or a refund.

```graphql
mutation updateCustomFields($input: UpdateCustomFieldsInput!) {
  updateCustomFields(input: $input) {
    clientMutationId
    customFields {
      name
      value
    }
  }
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)