App Submission Guide

Learn how to submit your app to Yapture Market and get approved quickly.

📋 Submission Checklist

✅ Have a Yapture account
✅ Register as a developer
✅ Wait for admin verification
✅ Prepare app assets (logo, screenshots, description)
✅ Submit app via API
✅ Wait for approval (typically 24-48 hours)

How to Request App Listing

Step 1: Create a Yapture Account

Before you can submit apps to the marketplace, you need a Yapture account:

Sign up at yapture.com
Verify your email address
Complete your profile

Step 2: Register as a Developer

Once you have a Yapture account, register as a developer:

POST https://yapture.market/api/dev/register
Content-Type: application/json
Authorization: Bearer <your-yapture-oauth-token>

{
  "name": "Your Name",
  "email": "you@example.com",
  "yaptureUserId": "<from-oauth-session>",
  "companyName": "Your Company (optional)",
  "websiteUrl": "https://yoursite.com (optional)",
  "bio": "Brief description of you and your work (optional)"
}

⏳ Verification Required: After registration, our team will verify your developer account within 24 hours. You'll receive an email notification once approved.

Step 3: Generate API Key

Once verified, generate an API key for app submissions:

POST https://yapture.market/api/dev/api-keys
Authorization: Bearer <your-yapture-oauth-token>

{
  "name": "Production API Key",
  "scopes": ["APP_CREATE", "APP_READ", "APP_UPDATE", "APP_DELETE", "ANALYTICS_READ"]
}

⚠️ Important: Save the API key immediately - it's only shown once!

Step 4: Prepare Your App

Before submitting, gather the following:

Asset	Requirements
Logo	Square image, min 512×512px, PNG or JPG
Banner	1200×600px, PNG or JPG (optional)
Screenshots	2-6 images showing app features, min 1280×720px
Description	Short (1-2 sentences) and long (detailed markdown)
Category	Choose from 10 available categories

Step 5: Submit Your App

Create your app listing (status will be DRAFT initially):

POST https://yapture.market/api/dev/apps
Authorization: Bearer <your-api-key>

{
  "name": "My Awesome App",
  "description": "Short one-liner for the app",
  "longDescription": "# Detailed Description\n\nExplain features, benefits...",
  "category": "PRODUCTIVITY",
  "environment": "production",
  "logoUrl": "https://cdn.example.com/logo.png",
  "bannerUrl": "https://cdn.example.com/banner.png",
  "websiteUrl": "https://myapp.com",
  "oauthClientId": "myapp-prod",
  "screenshots": [
    {
      "url": "https://cdn.example.com/screenshot1.png",
      "caption": "Main dashboard",
      "order": 0
    },
    {
      "url": "https://cdn.example.com/screenshot2.png",
      "caption": "Settings panel",
      "order": 1
    }
  ]
}

Step 6: Submit for Review

When ready, submit your app for admin review:

POST https://yapture.market/api/dev/apps/:appId/submit
Authorization: Bearer <your-api-key>

This changes your app status from DRAFT to PENDING. Our team will review within 24-48 hours.

Review Process

What We Check

Functionality: App works as described
Quality: Professional assets and clear documentation
Security: No malicious code or data harvesting
Terms of Service: Complies with Yapture Market ToS
User Experience: Good integration with Yapture

Approval

When approved:

✅ Your app appears on the marketplace immediately
✅ Users can discover and install your app
✅ You receive approval notification email
✅ Analytics tracking begins

Rejection

If rejected, you'll receive:

📧 Email with specific reasons for rejection
📝 Guidance on what needs to be fixed
🔄 Ability to update and resubmit

App Categories

PRODUCTIVITY

Task management, notes, calendars

UTILITIES

Tools and helpers

BUSINESS

CRM, invoicing, project management

DEVELOPER_TOOLS

APIs, SDKs, code tools

COMMUNICATION

Chat, email, notifications

ANALYTICS

Data visualization, reporting

AI_ML

Artificial intelligence, machine learning

FINANCE

Accounting, payments, budgeting

EDUCATION

Learning, courses, training

OTHER

Everything else

Best Practices

App Description

Write clear, concise short description (shown in listings)
Use markdown in long description for formatting
Include feature list and benefits
Mention Yapture integration points
Add links to documentation

Screenshots

Show actual app interface, not marketing graphics
Highlight key features in order
Use clear, readable text in screenshots
Add helpful captions to each screenshot
Keep screenshots up-to-date with app version

OAuth Integration

If your app uses OAuth for authentication:

Register OAuth client first (contact support)
Include oauthClientId in app submission
Test OAuth flow before submitting
Handle token refresh properly

After Approval

Track Performance

GET https://yapture.market/api/dev/apps/:appId/analytics

Response:
{
  "installCount": 152,
  "reviewCount": 23,
  "averageRating": 4.5,
  "status": "APPROVED",
  "featured": true
}

Update Your App

For approved apps:

Minor updates (URLs, typos): Contact support for admin edit
Major updates (features, redesign): Submit new version for review
Cannot edit approved apps directly via API (prevents malicious changes)

Support Users

Monitor reviews and respond to feedback
Keep documentation up-to-date
Provide support email in app listing
Fix bugs and release updates regularly

Common Issues

Can't submit app

Solution: Ensure developer account is verified by admin team.

API key not working

Solution: Check key has required scopes (APP_CREATE, etc.) and hasn't expired.

Screenshots not displaying

Solution: Use publicly accessible URLs (CDN recommended). Check CORS headers.

Need Help?

Contact our developer support team:

Email: developers@yapture.com
Documentation: Developer Docs
API Reference: API Reference

🚀 Ready to Submit?

Follow the steps above to get your app on Yapture Market. We're excited to see what you build!