Upsert Customer Custom Attribute - Automate.ax

square.upsertCustomerCustomAttribute creates or updates a custom attribute for a customer profile.

Example

automations/square-upsert-customer-custom-attribute.automation.ts

import { automation, onDashboardRun } from "automate.ax"
import { square } from "automate.ax/square"

export default automation("Upsert Square Customer Custom Attribute", () => {
  onDashboardRun({ title: "Upsert Square Customer Custom Attribute" })

  square.upsertCustomerCustomAttribute({
    customerId: "customer_id",
    key: "key",
    customAttribute: {
      value: "Dune",
    },
  })
})

Inputs

Every input accepts a compatible signal. It requires CUSTOMERS_WRITE.

Field	Type	Required	Default	Description
`customerId`	`string`	Yes	—	The ID of the target customer profile.
`key`	`string`	Yes	—	The key of the custom attribute to create or update. This key must match the `key` of a custom attribute definition in the Square seller account. If the requesting application is not the definition owner, you must use the qualified key.
`customAttribute`	`Square.CustomAttribute`	Yes	—	The custom attribute to create or update, with the following fields: - `value`. This value must conform to the `schema` specified by the definition. For more information, see Value data types. - `version`. To enable optimistic concurrency control for an update operation, include this optional field and specify the current version of the custom attribute.
`idempotencyKey`	`string \| null`	No	—	A unique identifier for this request, used to ensure idempotency. For more information, see Idempotency.

Use the official UpsertCustomerCustomAttribute reference for provider field semantics and limits.

Output

Returns the official Square.UpsertCustomerCustomAttributeResponse response as a codec-safe object. Square integer money amounts remain bigint values.