Batch upsert catalog objects

documented

Creates or updates up to 10,000 catalog objects.

POST /v2/catalog/batch-upsertCommerceno implementation yet0 runs

No implementation yet. Run it to have the agent write one, or open a pull request with your own.

Seed example (keychains curl)

npx -y keychains@latest curl "https://connect.squareup.com/v2/catalog/batch-upsert" \
  -X POST \
  -H "Square-Version: 2026-01-22" \
  -H "Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{\n    "idempotency_key": "{{$idempotency_key}}",\n    "batches": [\n      {\n        "objects": [\n          {\n            "type": "ITEM",\n            "id": "#{{$new_item_id}}",\n            "present_at_all_locations": true,\n            "item_data": {\n              "name": "{{$item_name}}",\n              "description_html": "<p>{{$item_description}}</p>",\n              "variations": [\n                {\n                  "type": "ITEM_VARIATION",\n                  "id": "#{{$variation_id}}",\n                  "item_variation_data": {\n                    "name": "{{$variation_name}}",\n                    "pricing_type": "FIXED",\n                    "price_money": {\n                      "amount": {{$price_amount}},\n                      "currency": "USD"\n                    }\n                  }\n                }\n              ]\n            }\n          }\n        ]\n      }\n    ]\n  }'"}