Testers Community
Sandbox — Safe demo mode
POST/api/v1/partner/apps

Submit App

Submit a new Android app for closed testing. The app will be added to the testing queue and testers will be assigned automatically.

Request Builder

Body
required
required
required
required
required
required

Response

Click "Send Request" to see the response

Code Examples

curl -X POST "https://api.testerscommunity.com/api/v1/partner/apps" \
  -H "X-Partner-API-Key: pk_demo_sample_key_for_testing" \
  -H "Content-Type: application/json" \
  -d '{}'

Field Reference

Submit a new Android app to the Testers Community closed testing program. Once submitted, your app enters the testing queue where testers will be assigned automatically based on availability.

Parameters

app_namestringrequired

The display name of your app as shown to testers. This should match your Play Store listing for consistency.

Format: Text, max 255 characters
Weather Pro
  • *Use your app's official Play Store name
  • *Keep it recognizable for testers
play_store_urlstringrequired

The complete Google Play Store URL for your app. This is how testers will access your app for testing.

Format: Valid Play Store URL with id= parameter
https://play.google.com/store/apps/details?id=com.yourcompany.app
  • *Copy directly from your Play Console or Play Store listing
  • *Must include the full URL with the package ID
  • *App must be in closed testing with open enrollment
developer_namestringrequired

Your company or developer name for attribution in reports and tester communications.

Format: Text, max 255 characters
Acme Inc
  • *Use your official Google Play developer account name
app_icon_urlstringrequired

A publicly accessible URL to your app's icon. This will be displayed in dashboards and reports.

Format: Direct URL to image (PNG, WebP, or JPG)
https://play-lh.googleusercontent.com/...
  • *You can use your Play Store icon URL
  • *Image should be at least 192x192 pixels
  • *Must be publicly accessible (no authentication required)
instructionsstringrequired

Testing guidelines that testers will follow when testing your app. Clear, detailed instructions lead to better quality feedback.

Format: Free-form text
Please test the weather forecast feature. Try different locations, check hourly and weekly forecasts, and report any display issues.
  • *Be specific about features to test
  • *Mention edge cases to explore
  • *Include any test credentials or data needed
  • *Clear instructions = better feedback quality
external_idstringrequired

Your own unique identifier for this app - use any ID from your system (like your database record ID, user ID, order ID, or any internal reference). This lets you retrieve the app's progress later using your own identifier instead of memorizing ours.

Format: Text, max 255 characters, must be unique across your submissions
user_12345_order_abc
  • *Use your existing database ID, user ID, or order ID
  • *Example: If your user "12345" submits an app, use "user_12345_appname"
  • *Must be unique across all your submissions
  • *This exact ID is used in Get App Progress to retrieve status
How external_id Works

Think of external_id as a bridge between your system and ours. If you store app submissions in your database with ID "user_12345_order_abc", use that same ID here. Later, when you call Get App Progress, you'll use this same ID to retrieve the status - no need to store or remember any ID we generate.

Error Responses

400
VALIDATION_ERROR

Invalid request body. Check: all required fields are provided, play_store_url is a valid Google Play Store link

401
INVALID_API_KEY

Invalid or missing API key

409
DUPLICATE_EXTERNAL_ID

An app with this external_id already exists for your account

429
SUBMISSION_LIMIT_REACHED

Your submission limit has been reached. Purchase additional credits or contact support to continue.