Create catalog image

documented

Uploads an image for a catalog object.

POST /v2/catalog/imagesCommerceno 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/images" \
  -X POST \
  -H "Square-Version: 2026-01-22" \
  -H "Authorization: Bearer {{OAUTH2_ACCESS_TOKEN}}" \
  -H "Accept: application/json" \
  -F "file=@{{$image_file_path}}" \
  -F 'request={
    "idempotency_key": "{{$idempotency_key}}",
    "object_id": "{{$object_id}}",
    "image": {
      "id": "{{$image_temp_id}}",
      "type": "IMAGE",
      "image_data": {
        "caption": "{{$image_caption}}"
      }
    }
  }'