Clarification on Managing Bundle Items via Square Catalog API

Questions
,
1

Dear Square Support Team,

I hope this message finds you well.

We are currently working on integrating the Square Catalog API into our internal tools to automate item management for our business accounts. During our research, we found references in developer forums indicating that Bundle Items can only be managed via the Square Dashboard and are not supported by the Catalog API.

To align our implementation plan with Square’s current API capabilities and roadmap, could you please confirm the following:

  1. Is it currently possible to create or manage Bundle Items (bundle-type catalog objects) using the Square Catalog API?
  2. If not supported, are there any plans to support Bundle Items management via the Catalog API in the near future?
  3. Is there any official documentation link that we can include in our internal documentation regarding this limitation for compliance and future reference?

Your confirmation will help us clarify this limitation with our engineering and product teams and ensure we adopt the correct implementation approach when using Square’s services.

Thank you in advance for your assistance.

Best regards,
MurphyMurphy

2

:waving_hand: I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:

Additional Documentation

Design a Catalog
Archive Catalog Items and Manage Archived Items
Manage Images in a Square Catalog

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.

3

  1. Is it currently possible to create or manage Bundle Items (bundle-type catalog objects) using the Square Catalog API?

    As of the latest information available, the Square Catalog API does not support the creation or management of Bundle Items (bundle-type catalog objects). Bundle Items can only be managed via the Square Dashboard.

  2. If not supported, are there any plans to support Bundle Items management via the Catalog API in the near future?

    There is no official information available regarding plans to support Bundle Items management via the Catalog API. For the most accurate and up-to-date information, it is recommended to keep an eye on Square’s developer updates or announcements.

  3. Is there any official documentation link that we can include in our internal documentation regarding this limitation for compliance and future reference?

    While there is no specific documentation link provided in the context regarding this limitation, you can refer to the general Catalog API documentation on Square’s developer site for the most comprehensive and current information. It is advisable to regularly check the official Square Developer documentation for any updates or changes.

This answer was reviewed by @josh-square.

4

Hi Square Team,

Thank you for letting me know that the Square API does not support creating or managing Bundle Items.

If I create Bundle Items through the Square Dashboard, is there an API available that allows me to retrieve detailed information about these Bundle Items?

If such an API is available, could you please provide:

  • The API documentation URL.
  • An example of the API response for a Bundle Item.

Your clarification would be greatly appreciated as we explore options for integrating Bundle Items into our workflows.

Thank you for your support!

Best regards,
Murphy

5

Sorry, to clarify there is no support for Bundle items via the API, including just retrieving information about them. You can retrieve the catalog object that represents the bundle, but it’ll be returned as a normal ITEM object, without any special bundle information included.