***

title: Publishing to App Store
description: Submit your app to the Deel App Store marketplace
--------------------------------------------------------------

## Overview

Once you've built and tested your OAuth2 app, you're ready to submit it to the Deel App Store. This guide covers the submission process, review requirements, and what to expect after your app goes live.

1. Gather requirements and polish your app
2. Submit through Developer Center
3. Launch to 36,000+ companies

<Warning>
  **Marketing restrictions:** If your app is not listed on the Deel App Store or approved by Deel, you cannot publicly market the app as a Deel integration. Only apps that have been reviewed and published to the App Store may be promoted as official Deel integrations.
</Warning>

## Submission Checklist

Use this comprehensive checklist to ensure your app is ready for submission:

<AccordionGroup>
  <Accordion title="OAuth Integration" icon="lock">
    **Required:**

    * [ ] OAuth2-based integration implemented
    * [ ] Authorization flow tested end-to-end
    * [ ] Token refresh works automatically
    * [ ] Secure token storage (encrypted at rest)
  </Accordion>

  <Accordion title="App Store Card Details" icon="id-card">
    **Required:**

    * [ ] Logo (1:1 aspect ratio, PNG format, 512x512px minimum)
    * [ ] Short description (1-line description of your app)
    * [ ] App name and tagline
  </Accordion>

  <Accordion title="App Store Page Details" icon="browser">
    **Required:**

    * [ ] Long description (detailed product/company description)
    * [ ] App description & features (what it does, key features)
    * [ ] Landing page URL (for referrals)
    * [ ] Category (HRIS, Accounting, Project Management, etc.)
    * [ ] Screenshots (at least 3, showing key features)
  </Accordion>

  <Accordion title="Help Information" icon="circle-question">
    **Required:**

    * [ ] Help article (step-by-step setup guide)
    * [ ] Support email (for end users)
    * [ ] Support documentation or help center URL
  </Accordion>

  <Accordion title="Material for Deel" icon="file-video">
    **Required:**

    * [ ] Integration demo video
    * [ ] Escalation email (for Deel support team)
    * [ ] Test account details (URL and testing credentials)

    **Optional:**

    * [ ] Pricing page URL
    * [ ] Company FAQ page
  </Accordion>

  <Accordion title="Legal Documents" icon="file-contract">
    **Required:**

    * [ ] Privacy policy URL
    * [ ] Terms of service URL
    * [ ] Data usage disclosure
    * [ ] Compliance statements (GDPR, SOC 2, etc.)
  </Accordion>

  <Accordion title="Technical Requirements" icon="code">
    **Required:**

    * [ ] HTTPS for all endpoints
    * [ ] Error handling for all API calls
    * [ ] Rate limiting respected
    * [ ] No hardcoded credentials
    * [ ] Webhook signature verification (if using webhooks)
    * [ ] Sandbox testing completed successfully
  </Accordion>
</AccordionGroup>

## Submission Process

<Steps>
  <Step title="Navigate to Developer Center">
    Go to [app.deel.com](https://app.deel.com) → **Settings** → **Developer Center**
  </Step>

  <Step title="Select Your App">
    Choose the app you want to submit from your apps list
  </Step>

  <Step title="Click Submit for Review">
    Click **Submit for Review** button
  </Step>

  <Step title="Complete Submission Form">
    Fill in all required information:

    * App description and value proposition
    * Category and tags
    * Screenshots and branding assets
    * Legal documents (privacy policy, terms)
    * Support information
    * Pricing model (if applicable)
  </Step>

  <Step title="Review and Submit">
    Review all information for accuracy and completeness, then submit
  </Step>
</Steps>

<Info>
  **Initial access:** Once submitted, your app will be accessible only to your organization for internal testing while it's under review.
</Info>

## Review Process

### What We Review

Deel performs a comprehensive review of your app:

<Tabs>
  <Tab title="Technical Review">
    **OAuth2 Implementation:**

    * Authorization flow works correctly
    * Token exchange and refresh implemented properly
    * Secure token storage
    * Proper error handling

    **Security:**

    * HTTPS for all communications
    * No exposed secrets or credentials
    * Secure data handling
    * Webhook signature verification (if applicable)

    **API Usage:**

    * Correct endpoint usage
    * Rate limiting respected
    * Proper error handling for API responses
    * Efficient API calls (no excessive polling)

    **Performance:**

    * Response times are reasonable
    * No memory leaks or resource issues
    * Handles concurrent users appropriately
  </Tab>

  <Tab title="App Store Listing">
    **Branding:**

    * Professional logo and icon
    * High-quality screenshots
    * Clear and accurate description
    * Proper categorization

    **Documentation:**

    * Clear setup instructions
    * User documentation available
    * Support resources accessible
    * Troubleshooting guides

    **Legal Compliance:**

    * Valid privacy policy
    * Terms of service present
    * Data usage clearly disclosed
    * Compliance with regulations
  </Tab>

  <Tab title="User Experience">
    **Onboarding:**

    * Clear authorization flow
    * Easy to understand permissions
    * Helpful getting started guide
    * Smooth initial setup

    **Functionality:**

    * App works as described
    * No major bugs or issues
    * Error messages are helpful
    * Expected features are present

    **Support:**

    * Contact information provided
    * Support channels accessible
    * Documentation comprehensive
    * FAQ or help center available
  </Tab>
</Tabs>

### Review Timeline

<Steps>
  <Step title="Submission Received">
    You'll receive confirmation that your submission was received (immediate)
  </Step>

  <Step title="Initial Review">
    Our team performs an initial completeness check (1-2 business days)
  </Step>

  <Step title="Technical Review">
    Comprehensive technical evaluation (3-5 business days)
  </Step>

  <Step title="App Store Review">
    Listing and user experience review (2-3 business days)
  </Step>

  <Step title="Decision">
    You'll receive approval or feedback for revisions (typically 1-2 weeks total)
  </Step>
</Steps>

<Note>
  **Timeline may vary:** Review time depends on submission complexity and current queue. We'll contact you if we need additional information.
</Note>

## Common Rejection Reasons

Avoid these common issues that can delay approval:

<AccordionGroup>
  <Accordion title="Incomplete OAuth2 Implementation" icon="lock">
    **Issue:** Token refresh not implemented or authorization flow has bugs

    **Solution:**

    * Test the complete OAuth2 flow end-to-end
    * Implement automatic token refresh
    * Handle all OAuth error scenarios
    * Follow our [OAuth2 documentation](/api/oauth)
  </Accordion>

  <Accordion title="Missing or Invalid Documentation" icon="file">
    **Issue:** Privacy policy, terms of service, or user documentation missing or inadequate

    **Solution:**

    * Provide valid URLs for all legal documents
    * Ensure documents are accessible and up-to-date
    * Include comprehensive user documentation
    * Add setup instructions and troubleshooting guides
  </Accordion>

  <Accordion title="Security Concerns" icon="shield-exclamation">
    **Issue:** Credentials exposed, insecure token storage, or missing HTTPS

    **Solution:**

    * Use HTTPS for all endpoints
    * Store tokens encrypted at rest
    * Never expose client secrets
    * Implement proper webhook signature verification
  </Accordion>

  <Accordion title="Poor User Experience" icon="face-frown">
    **Issue:** Confusing setup, unclear errors, or broken functionality

    **Solution:**

    * Provide clear onboarding instructions
    * Show helpful error messages
    * Test all user flows thoroughly
    * Include loading states and feedback
  </Accordion>

  <Accordion title="Inadequate Branding" icon="image">
    **Issue:** Low-quality logo, missing screenshots, or unclear description

    **Solution:**

    * Use high-resolution logo (512x512px minimum)
    * Provide at least 3 clear screenshots
    * Write a detailed, accurate description
    * Clearly explain your app's value proposition
  </Accordion>
</AccordionGroup>

## After Approval

Once your app is approved:

### Going Live

<Steps>
  <Step title="Approval Notification">
    You'll receive an email confirming your app has been approved
  </Step>

  <Step title="App Store Listing">
    Your app appears in the Deel App Store marketplace
  </Step>

  <Step title="Customer Access">
    All Deel customers can discover and install your app
  </Step>
</Steps>

### Post-Launch Responsibilities

<AccordionGroup>
  <Accordion title="Monitoring" icon="chart-line">
    Track your app's health and performance:

    * Monitor installation rates
    * Track API usage and errors
    * Review customer feedback
    * Watch for OAuth failures
    * Check webhook delivery rates (if applicable)
  </Accordion>

  <Accordion title="Support" icon="headset">
    Provide excellent customer support:

    * Respond to customer inquiries promptly
    * Monitor support channels
    * Update documentation as needed
    * Address bugs and issues quickly
    * Provide clear troubleshooting guides
  </Accordion>

  <Accordion title="Maintenance" icon="wrench">
    Keep your app up-to-date:

    * Fix bugs and security issues promptly
    * Add new features based on feedback
    * Update for new API versions
    * Maintain OAuth2 token handling
    * Test regularly with sandbox
  </Accordion>

  <Accordion title="Communication" icon="megaphone">
    Keep customers informed:

    * Announce new features and updates
    * Communicate maintenance windows
    * Share changelogs and release notes
    * Notify of breaking changes in advance
    * Maintain an active presence
  </Accordion>
</AccordionGroup>

## App Store Best Practices

<AccordionGroup>
  <Accordion title="Optimize Your Listing" icon="star">
    Make your app stand out:

    * Use clear, benefit-focused description
    * Include high-quality screenshots showing key features
    * Add a demo video if possible
    * Use relevant tags and categories
    * Highlight unique value propositions
  </Accordion>

  <Accordion title="Provide Excellent Onboarding" icon="map">
    Make it easy for users to get started:

    * Clear setup instructions
    * Guided first-time experience
    * Help documentation readily available
    * Quick wins in first 5 minutes
    * Examples and use cases
  </Accordion>

  <Accordion title="Build for Scale" icon="arrow-up-right-dots">
    Prepare for growth:

    * Handle increased API load
    * Scale infrastructure appropriately
    * Monitor performance metrics
    * Optimize database queries
    * Use caching where appropriate
  </Accordion>

  <Accordion title="Engage with Users" icon="comments">
    Build a community:

    * Respond to feedback promptly
    * Request reviews and testimonials
    * Share success stories
    * Participate in Deel developer community
    * Iterate based on user needs
  </Accordion>
</AccordionGroup>

## Getting Featured

Want your app featured in the Deel App Store?

<Steps>
  <Step title="Build Quality">
    Maintain high quality standards:

    * Excellent user reviews
    * Low error rates
    * Fast response times
    * Active development
  </Step>

  <Step title="Gain Traction">
    Grow your user base:

    * Reach significant install numbers
    * Show strong engagement metrics
    * Demonstrate value to customers
    * Collect positive testimonials
  </Step>

  <Step title="Partner with Deel">
    Engage with our team:

    * Share your success story
    * Participate in case studies
    * Join co-marketing opportunities
    * Present at Deel events
  </Step>
</Steps>

<Tip>
  **Get in touch:** Contact our partnership team to discuss featuring opportunities and co-marketing initiatives.
</Tip>