PUT /v1/{location_id}/items/{item_id}/fees/{fee_id}

Name	Description
`location_id string` Required	The ID of the fee's associated location.
`item_id string` Required	The ID of the item to add the fee to.
`fee_id string` Required	The ID of the fee to apply.

Name	Description
`id string`	The item's ID. Must be unique among all entity IDs ever provided on behalf of the merchant. You can never reuse an ID. This value can include alphanumeric characters, dashes (-), and underscores (_).
`name string`	The item's name.
`description string`	The item's description.
`type string`	The item's type. This value is NORMAL for almost all items.
`color string`	The color of the discount's display label in Square Point of Sale, if not the default color. The default color is 9da2a6.
`abbreviation string`	The text of the item's display label in Square Point of Sale. Only up to the first five characters of the string are used.
`visibility string`	Indicates whether the item is viewable from the merchant's online store (PUBLIC) or PRIVATE.
`available_online boolean`	If true, the item can be added to shipping orders from the merchant's online store.
`master_image ItemImage`	The item's master image, if any.
`category Category`	The category the item belongs to, if any.
`variations Variation [ ]`	The item's variations. You must specify at least one variation.
`modifier_lists ModifierList [ ]`	The modifier lists that apply to the item, if any.
`fees Fee [ ]`	The fees that apply to the item, if any.
`taxable boolean`	Deprecated. This field is not used.
`category_id string`	The ID of the item's category, if any.
`available_for_pickup boolean`	If true, the item can be added to pickup orders from the merchant's online store. Default value: false
`v2_id string`	The ID of the CatalogObject in the Connect v2 API. Objects that are shared across multiple locations share the same v2 ID.

The item's ID. Must be unique among all entity IDs ever provided on behalf of the merchant. You can never reuse an ID. This value can include alphanumeric characters, dashes (-), and underscores (_).

The item's name.


        
  
  
          description
        


        

        
    string

The item's description.

The item's type. This value is NORMAL for almost all items.

The color of the discount's display label in Square Point of Sale, if not the default color. The default color is 9da2a6.


        
  
  
          abbreviation
        


        

        
    string

The text of the item's display label in Square Point of Sale. Only up to the first five characters of the string are used.


        
  
  
          visibility
        


        

        
    string

Indicates whether the item is viewable from the merchant's online store (PUBLIC) or PRIVATE.


        
  
  
          available_online
        


        

        
    boolean

If true, the item can be added to shipping orders from the merchant's online store.


        
  
  
          master_image
        


        

        
    
      ItemImage

The item's master image, if any.

The category the item belongs to, if any.


        
  
  
          variations
        


        

        
      
        Variation [ ]

The item's variations. You must specify at least one variation.


        
  
  
          modifier_lists
        


        

        
      
        ModifierList [ ]

The modifier lists that apply to the item, if any.

The fees that apply to the item, if any.

Deprecated. This field is not used.


        
  
  
          category_id
        


        

        
    string

The ID of the item's category, if any.


        
  
  
          available_for_pickup
        


        

        
    boolean

If true, the item can be added to pickup orders from the merchant's online store. Default value: false

The ID of the CatalogObject in the Connect v2 API. Objects that are shared across multiple locations share the same v2 ID.

You are viewing an old version of the API

All Versions

Apply fee
V1

Square V1 APIs
We recommend using the Square API (V2) for all new development when possible. See When to use Connect V1 to learn more about working with V1 endpoints.

Deprecation date

Retirement date

Replaced by

Path Parameters

Response Fields

Examples

Share Feedback

Catalog API You are viewing an old version of the API 2020-06-25 Version 2020-06-25 All Versions Catalog API Apply fee V1 Square V1 APIs We recommend using the Square API (V2) for all new development when possible. See When to use Connect V1 to learn more about working with V1 endpoints.