sync_iap_products

Sync in-app purchases between AppStore Copilot and App Store Connect (push or pull).

Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project ID
`direction`	`string`	Yes	"push" (to App Store) or "pull" (from App Store)
`iapIds`	`string[]`	No	Specific IAP IDs to sync
`subscriptionIds`	`string[]`	No	Specific subscription IDs to sync
`pushAll`	`boolean`	No	Push all pending products (default: false)

Example Usage

Natural Language Promptstext

"Push my IAPs to App Store Connect"

"Pull existing in-app purchases from the App Store"

"Sync the premium subscription to App Store Connect"

Response

{
  "success": true,
  "summary": {
    "created": ["com.app.coins_100", "com.app.premium_monthly"],
    "updated": ["com.app.remove_ads"],
    "errors": []
  }
}

Validation

When pushing, products are validated for required fields (localizations, pricing). If validation fails, you'll receive suggested actions to fix each issue.

Validation Response

{
  "success": false,
  "validationFailed": true,
  "validationMessage": "2 products are missing required fields",
  "validationIssues": [
    {
      "id": "iap_abc123",
      "productId": "com.app.coins_100",
      "type": "iap",
      "missingFields": ["Pricing", "Localizations"],
      "suggestedActions": [
        {
          "tool": "setIAPPricing",
          "description": "Set a base price for the IAP"
        },
        {
          "tool": "translateIAPProduct",
          "description": "Add localizations"
        }
      ]
    }
  ]
}