> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# accountAttributesSet

> Set or clear account attributes. Applies every change or none. At most 50 per call, each name once. Returns the account after the change.

**Required scopes:** [`account_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-account_write)

## Arguments

**attributes** `[\[AccountAttributeInput!\]!](/docs/api-reference/v3/reference/account/account-attribute-input)` *required*

The attributes to set or clear.

**fields**

**name** `String!` *required*

The attribute's machine name. The merchant defines account attributes in Settings; an unknown name is BAD\_USER\_INPUT.

**value** `[JSON](/docs/api-reference/v3/reference/common/json)`

The value, in the JSON shape documented on its AttributeType (e.g. WEIGHT is \{ value, unit }, INTEGER a decimal string). Null or omitted clears it. A value that doesn't fit the type is BAD\_USER\_INPUT.

## Returns

**accountAttributesSet** `[Account!](/docs/api-reference/v3/reference/account/account)` *required*

The store's account. One per store.

**fields**

**attribute** `[Attribute](/docs/api-reference/v3/reference/catalog/attribute)`

Look up a single attribute on the account by its name. Null when it isn't defined or isn't set.

**Requires:** [`account_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-account_read)

**fields**

**Arguments**

**name** `String!` *required*

The machine name of the attribute to look up.

**Fields**

**description** `String`

An optional description of what the attribute represents.

**displayName** `String!` *required*

The human-readable label shown for the attribute.

**id** `ID!` *required*

The unique identifier of the attribute's definition.

**name** `String!` *required*

The attribute's machine name, unique within the account.

**type** `[AttributeType!](/docs/api-reference/v3/reference/catalog/attribute-type)` *required*

The data type of the attribute's value.

**value** `[JSON](/docs/api-reference/v3/reference/common/json)`

The attribute's value, resolved to the typed JSON form for its `type` — read `type` to know the shape. E.g. SHORT\_TEXT → a string, WEIGHT → \{ value, unit }, MONEY → \{ amount, currency }. Null if unset. See AttributeType for each type's shape.

**attributes** `[\[Attribute!\]!](/docs/api-reference/v3/reference/catalog/attribute)` *required*

The merchant-defined attributes set on the account, by name. Attributes defined but not set are left out.

**fields**

**description** `String`

An optional description of what the attribute represents.

**displayName** `String!` *required*

The human-readable label shown for the attribute.

**id** `ID!` *required*

The unique identifier of the attribute's definition.

**name** `String!` *required*

The attribute's machine name, unique within the account.

**type** `[AttributeType!](/docs/api-reference/v3/reference/catalog/attribute-type)` *required*

The data type of the attribute's value.

**value** `[JSON](/docs/api-reference/v3/reference/common/json)`

The attribute's value, resolved to the typed JSON form for its `type` — read `type` to know the shape. E.g. SHORT\_TEXT → a string, WEIGHT → \{ value, unit }, MONEY → \{ amount, currency }. Null if unset. See AttributeType for each type's shape.

## Example

```graphql theme={null}
mutation {
  accountAttributesSet(attributes: { ... })
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.