IAP Media Tools
Upload review screenshots and promotional images for in-app purchases and subscriptions using AI assistants like Claude.
Required for App Store Submission
Review screenshots are required for App Store submission of in-app purchases and subscriptions. Promotional images are optional but recommended for featuring in the App Store.
Overview
These tools allow you to manage media assets for your in-app purchases and subscriptions:
| Tool | Description |
|---|---|
get_iap_screenshot | Get the current review screenshot for an IAP |
upload_iap_screenshot | Upload a review screenshot for an IAP |
delete_iap_screenshot | Delete the review screenshot for an IAP |
get_iap_promotional_image | Get the current promotional image for an IAP |
upload_iap_promotional_image | Upload a promotional image for an IAP |
delete_iap_promotional_image | Delete the promotional image for an IAP |
get_subscription_screenshot | Get the current review screenshot for a subscription |
upload_subscription_screenshot | Upload a review screenshot for a subscription |
delete_subscription_screenshot | Delete the review screenshot for a subscription |
get_subscription_promotional_image | Get the current promotional image for a subscription |
upload_subscription_promotional_image | Upload a promotional image for a subscription |
delete_subscription_promotional_image | Delete the promotional image for a subscription |
upload_iap_screenshot / upload_subscription_screenshot
Upload a review screenshot for an in-app purchase or subscription. The screenshot is displayed to App Store reviewers during the review process.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | The project ID |
iapId / subscriptionId | string | Yes | The IAP or subscription ID |
fileName | string | Yes | File name (e.g., "screenshot.png") |
imageData | string | Yes | Base64 encoded image data (without data URL prefix) |
mimeType | string | No | Image MIME type (default: image/png) |
Response
{"success": true,"screenshot": {"fileName": "screenshot.png","mimeType": "image/png","fileSize": 245678,"r2Url": "https://cdn.appstorecopilot.com/iap-media/..."}}
upload_iap_promotional_image / upload_subscription_promotional_image
Upload a promotional image for an in-app purchase or subscription. Promotional images are used in App Store promotional campaigns and featured placements.
Parameters
Same parameters as screenshot upload tools.
Response
{"success": true,"image": {"fileName": "promo.png","mimeType": "image/png","fileSize": 512000,"r2Url": "https://cdn.appstorecopilot.com/iap-media/..."}}
Image Specifications
| Type | Size | Format | Purpose |
|---|---|---|---|
| Review Screenshot | 640 x 920 px | PNG, JPEG | Shown to App Store reviewers |
| Promotional Image | 1024 x 1024 px | PNG, JPEG | Featured in App Store promotions |
File Size Limit
Maximum file size is 5MB. Images are stored in Cloudflare R2 and served via CDN.
Example Usage
Ask Claude to upload media for your IAP or subscription:
"Upload a review screenshot for my premium subscription""Add a promotional image to the 100 coins IAP""Get the current screenshot for subscription sub_abc123""Delete the promotional image from the pro_monthly subscription"
Get & Delete Tools
The get and delete tools take only projectId and iapId or subscriptionId parameters.
Get Response
{"success": true,"screenshot": {"fileName": "screenshot.png","mimeType": "image/png","fileSize": 245678,"r2Url": "https://cdn.appstorecopilot.com/iap-media/...","uploadedAt": "2024-01-15T10:30:00Z"}}// If no screenshot exists:{"success": true,"screenshot": null}
Delete Response
{"success": true}
Pro Tip
Use the generate_screenshot tool to create marketing screenshots, then use these IAP media tools to upload them as review screenshots for your in-app purchases and subscriptions.