Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In
  • Home

  • Dev Essentials

  • Payments

  • Commerce

  • Customers

  • Staff

  • Merchants

    • Merchants

    • Merchant Custom Attributes

    • Locations

    • Location Custom Attributes

  • Objects & Enums

  • Webhook Events

  • Deprecated

  • SDKs

<- Square API

Square API

All versions ->

Merchant Custom Attributes

Create and manage merchant-related custom attribute definitions and custom attributes.

Use the Merchant Custom Attributes API to create and manage custom attributes for merchants that connect to your application. Custom attributes can be used to store properties or metadata that simplify integration, synchronization, and personalization workflows.

For more information, see the following guides:

  • Merchant Custom Attributes
  • Square Webhooks Overview
  • Endpoints

  • Webhooks

All versions ->

merchant.custom_attribute_definition.owned.created

Published when a merchant custom attribute definition is created by the subscribing application

Beta

merchant.custom_attribute_definition.owned.deleted

Published when a merchant custom attribute definition is deleted by the subscribing application

Beta

merchant.custom_attribute_definition.owned.updated

Published when a merchant custom attribute definition is updated by the subscribing application

Beta

merchant.custom_attribute_definition.visible.created

Published when a merchant custom attribute definition that is visible to the subscribing application is created

Beta

merchant.custom_attribute_definition.visible.deleted

Published when a merchant custom attribute definition that is visible to the subscribing application is deleted

Beta

merchant.custom_attribute_definition.visible.updated

Published when a merchant custom attribute definition that is visible to the subscribing application is updated

Beta

merchant.custom_attribute.owned.deleted

Published when a merchant custom attribute associated with a custom attribute definition that is owned by the subscribing application is deleted

Beta

merchant.custom_attribute.owned.updated

Published when a merchant custom attribute associated with a custom attribute definition that is owned by the subscribing application is updated

Beta

merchant.custom_attribute.visible.deleted

Published when a merchant custom attribute with the visibility field set to VISIBILITYREADONLY or VISIBILITYREADWRITE_VALUES is deleted. An application that subscribes to this event is notified when a merchant custom attribute is deleted by any application for which the subscribing application has read access to the merchant custom attribute.

Beta

merchant.custom_attribute.visible.updated

Published when a merchant custom attribute with the visibility field set to VISIBILITYREADONLY or VISIBILITYREADWRITE_VALUES is updated. An application that subscribes to this event is notified when a merchant custom attribute is updated by any application for which the subscribing application has read access to the merchant custom attribute.

Beta