Partners

Publishing to App Store

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

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.

Submission Checklist

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

Required:

  • OAuth2-based integration implemented
  • Authorization flow tested end-to-end
  • Token refresh works automatically
  • Secure token storage (encrypted at rest)

Required:

  • Logo (1:1 aspect ratio, PNG format, 512x512px minimum)
  • Short description (1-line description of your app)
  • App name and tagline

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)

Required:

  • Help article (step-by-step setup guide)
  • Support email (for end users)
  • Support documentation or help center URL

Required:

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

Optional:

  • Pricing page URL
  • Company FAQ page

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

Submission Process

2

Select Your App

Choose the app you want to submit from your apps list

3

Click Submit for Review

Click Submit for Review button

4

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)
5

Review and Submit

Review all information for accuracy and completeness, then submit

Initial access: Once submitted, your app will be accessible only to your organization for internal testing while it’s under review.

Review Process

What We Review

Deel performs a comprehensive review of your app:

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

Review Timeline

1

Submission Received

You’ll receive confirmation that your submission was received (immediate)

2

Initial Review

Our team performs an initial completeness check (1-2 business days)

3

Technical Review

Comprehensive technical evaluation (3-5 business days)

4

App Store Review

Listing and user experience review (2-3 business days)

5

Decision

You’ll receive approval or feedback for revisions (typically 1-2 weeks total)

Timeline may vary: Review time depends on submission complexity and current queue. We’ll contact you if we need additional information.

Common Rejection Reasons

Avoid these common issues that can delay approval:

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

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

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

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

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

After Approval

Once your app is approved:

Going Live

1

Approval Notification

You’ll receive an email confirming your app has been approved

2

App Store Listing

Your app appears in the Deel App Store marketplace

3

Customer Access

All Deel customers can discover and install your app

Post-Launch Responsibilities

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)

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

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

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

App Store Best Practices

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

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

Prepare for growth:

  • Handle increased API load
  • Scale infrastructure appropriately
  • Monitor performance metrics
  • Optimize database queries
  • Use caching where appropriate

Build a community:

  • Respond to feedback promptly
  • Request reviews and testimonials
  • Share success stories
  • Participate in Deel developer community
  • Iterate based on user needs

Want your app featured in the Deel App Store?

1

Build Quality

Maintain high quality standards:

  • Excellent user reviews
  • Low error rates
  • Fast response times
  • Active development
2

Gain Traction

Grow your user base:

  • Reach significant install numbers
  • Show strong engagement metrics
  • Demonstrate value to customers
  • Collect positive testimonials
3

Partner with Deel

Engage with our team:

  • Share your success story
  • Participate in case studies
  • Join co-marketing opportunities
  • Present at Deel events

Get in touch: Contact our partnership team to discuss featuring opportunities and co-marketing initiatives.