For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeel Home
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
  • Resources
    • Blog
    • Community
    • API spec
  • Get Started
    • Quickstart
    • Sandbox
  • Essentials
    • Authentication
    • API versioning
    • OAuth 2.0
    • Rate Limits
    • Idempotency
    • Best Practices
  • Webhooks
    • Introduction
    • Quickstart
    • No Code
    • Events
    • Simulations
  • Partners
    • Introduction
    • Getting Started
    • Publishing to App Store
LogoLogo
SupportDeel Home
On this page
  • Overview
  • Submission Checklist
  • Submission Process
  • Review Process
  • What We Review
  • Review Timeline
  • Common Rejection Reasons
  • After Approval
  • Going Live
  • Post-Launch Responsibilities
  • App Store Best Practices
  • Getting Featured
Partners

Publishing to App Store

Was this page helpful?
Previous
Built with

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 40,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:

OAuth Integration

Required:

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

Required:

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

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)
Help Information

Required:

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

Required:

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

Optional:

  • Pricing page URL
  • Company FAQ page
Legal Documents

Required:

  • Privacy policy URL
  • Terms of service URL
  • Data usage disclosure
  • Compliance statements (GDPR, SOC 2, etc.)
Technical Requirements

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

1

Navigate to Developer Center

Go to app.deel.com → Settings → Developer Center

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:

Technical Review
App Store Listing
User Experience

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:

Incomplete OAuth2 Implementation

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
Missing or Invalid 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
Security Concerns

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
Poor User Experience

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
Inadequate Branding

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

Monitoring

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

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
Maintenance

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
Communication

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

Optimize Your Listing

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
Provide Excellent Onboarding

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
Build for Scale

Prepare for growth:

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

Build a community:

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

Getting Featured

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.