[GH-ISSUE #194] Post-create app setup automation (public API only) #56

Closed
opened 2026-02-26 21:33:03 +03:00 by kerem · 1 comment
Owner

Originally created by @rudrankriyam on GitHub (Jan 26, 2026).
Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/194

Originally assigned to: @rudrankriyam on GitHub.

Overview

The public App Store Connect API does not support creating new app records. We will not use undocumented endpoints.
This issue tracks an officially supported alternative: post‑creation automation (configure everything after the app record is created manually in App Store Connect).

From the official Apps API docs: “Don’t use this API to create new apps; instead, create new apps on the App Store Connect website.”
Docs: https://sosumi.ai/documentation/appstoreconnectapi/apps

Scope (Supported API only)

Goal: provide CLI commands to finish app setup after manual creation.

Key resources we can update via public API:

  • App update (PATCH /v1/apps/{id}) — bundle ID, primary locale, price schedule, availability
    https://sosumi.ai/documentation/appstoreconnectapi/patch-v1-apps-id
  • App Info / App Info Localizations — name, subtitle, privacy policy URLs, etc.
  • Categories (primary/secondary)
  • Age Rating (already supported)
  • Pricing & availability (already supported)
  • App Store localizations (already supported)

Proposed CLI (post-create flow)

New group: asc app-setup <subcommand> [flags]

Subcommands (all use existing APIs):

  • app-setup info set --app APP_ID --primary-locale en-US --bundle-id BUNDLE_ID (wraps app update + app info)
  • app-setup categories set --app APP_ID --primary GAMES --secondary ENTERTAINMENT
  • app-setup availability set --app APP_ID --territory "USA,GBR" --available true
  • app-setup pricing set --app APP_ID --price-point PRICE_POINT_ID (or reuse pricing schedule)
  • app-setup localizations upload --version VERSION_ID --path ./localizations (existing)

Acceptance Criteria

  • Documented, no app creation via API
  • asc app-setup --help and basic flow exists
  • Uses only public endpoints documented by Apple
  • Clear error when users try to create app records (direct them to ASC UI)

Manual Test Plan (using real apps)

Prereq: create app record in ASC UI.

  1. asc apps → get APP_ID
  2. asc app-setup info set --app APP_ID --primary-locale en-US --bundle-id BUNDLE_ID
  3. asc app-setup categories set --app APP_ID --primary GAMES
  4. asc app-setup availability set --app APP_ID --territory "USA" --available true
  5. asc app-info get --app APP_ID (verify updated fields)
  6. asc categories list (verify category ids are valid)

Notes

  • Do not use undocumented endpoints.
  • Provide explicit user guidance in help text and README: “Create app record in App Store Connect UI first.”
  • Consider a single orchestration command app-setup init that chains the above steps.

Implementation Notes

  • Implement as wrapper commands that call existing client methods
  • If needed, add a small cmd/app_setup.go to orchestrate
  • Update README with a “Post-create setup” section
Originally created by @rudrankriyam on GitHub (Jan 26, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/194 Originally assigned to: @rudrankriyam on GitHub. # Overview The public App Store Connect API **does not support creating new app records**. We will **not** use undocumented endpoints. This issue tracks an officially supported alternative: **post‑creation automation** (configure everything after the app record is created manually in App Store Connect). > From the official Apps API docs: “Don’t use this API to create new apps; instead, create new apps on the App Store Connect website.” Docs: https://sosumi.ai/documentation/appstoreconnectapi/apps # Scope (Supported API only) Goal: provide CLI commands to **finish** app setup after manual creation. Key resources we can update via public API: - **App update** (`PATCH /v1/apps/{id}`) — bundle ID, primary locale, price schedule, availability https://sosumi.ai/documentation/appstoreconnectapi/patch-v1-apps-_id_ - **App Info / App Info Localizations** — name, subtitle, privacy policy URLs, etc. - **Categories** (primary/secondary) - **Age Rating** (already supported) - **Pricing & availability** (already supported) - **App Store localizations** (already supported) # Proposed CLI (post-create flow) New group: `asc app-setup <subcommand> [flags]` Subcommands (all use *existing* APIs): - `app-setup info set --app APP_ID --primary-locale en-US --bundle-id BUNDLE_ID` (wraps app update + app info) - `app-setup categories set --app APP_ID --primary GAMES --secondary ENTERTAINMENT` - `app-setup availability set --app APP_ID --territory "USA,GBR" --available true` - `app-setup pricing set --app APP_ID --price-point PRICE_POINT_ID` (or reuse pricing schedule) - `app-setup localizations upload --version VERSION_ID --path ./localizations` (existing) # Acceptance Criteria - [ ] Documented, **no app creation via API** - [ ] `asc app-setup --help` and basic flow exists - [ ] Uses only public endpoints documented by Apple - [ ] Clear error when users try to create app records (direct them to ASC UI) # Manual Test Plan (using real apps) Prereq: create app record in ASC UI. 1) `asc apps` → get `APP_ID` 2) `asc app-setup info set --app APP_ID --primary-locale en-US --bundle-id BUNDLE_ID` 3) `asc app-setup categories set --app APP_ID --primary GAMES` 4) `asc app-setup availability set --app APP_ID --territory "USA" --available true` 5) `asc app-info get --app APP_ID` (verify updated fields) 6) `asc categories list` (verify category ids are valid) # Notes - Do **not** use undocumented endpoints. - Provide explicit user guidance in help text and README: “Create app record in App Store Connect UI first.” - Consider a single orchestration command `app-setup init` that chains the above steps. # Implementation Notes - Implement as wrapper commands that call existing client methods - If needed, add a small `cmd/app_setup.go` to orchestrate - Update README with a “Post-create setup” section
kerem closed this issue 2026-02-26 21:33:03 +03:00
Author
Owner
<!-- gh-comment-id:3808155732 --> @rudrankriyam commented on GitHub (Jan 27, 2026): Closed as fixed by #224, #230. PRs: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/224, https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/230
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/App-Store-Connect-CLI#56
No description provided.