Marketplace Guidelines
Requirements and best practices for listing your app on the LendWorks marketplace.
Overview
The LendWorks Marketplace is where brokerages discover and install apps to enhance their workflows. Meeting these guidelines ensures a smooth review process and a quality experience for users.
Required Assets
Before submitting your app for review, provide the following:
App Icon
| Requirement | Value |
|---|---|
| Size | 512 x 512 px |
| Format | PNG or SVG |
| Background | Solid or transparent (no gradients that clash with dark/light themes) |
| Content | Clear, recognizable at 64 x 64 px |
Screenshots
| Requirement | Value |
|---|---|
| Minimum | 2 screenshots |
| Maximum | 8 screenshots |
| Size | 1280 x 800 px or 1920 x 1080 px |
| Format | PNG or JPEG |
| Content | Show the app in action — key features and workflows |
Descriptions
| Field | Length | Description |
|---|---|---|
| Short description | 80 characters max | One-line summary shown in search results |
| Full description | 3,000 characters max | Detailed explanation with features, use cases, and setup instructions |
| Category | Select one | CRM, Analytics, Automation, Communication, Compliance, Documents, Finance, Other |
Additional Requirements
- Privacy Policy URL — Link to your privacy policy
- Support URL — Where users can get help (email, docs, or support portal)
- Website URL — Your company or product website
- Pricing — Free, free trial, or paid (with pricing details)
Review Criteria
The review team evaluates apps across four areas:
1. Functionality
- App works as described in the listing
- OAuth flow completes without errors
- API calls handle errors gracefully (rate limits, permissions, network issues)
- App correctly handles scope limitations
- Webhooks are processed reliably (if used)
2. Security
- OAuth 2.0 + PKCE implemented correctly
- Client secrets stored server-side only
- Webhook signatures verified before processing
- No sensitive data logged or exposed in error messages
- HTTPS enforced for all endpoints (redirect URIs, webhooks)
3. User Experience
- Clear onboarding flow after installation
- Meaningful error messages (not raw API errors)
- Responsive design if the app has a web interface
- Reasonable performance (no excessive API calls)
4. Policy Compliance
- Adheres to the LendWorks Terms of Service
- Does not scrape or harvest data beyond stated scope
- Does not impersonate LendWorks or other apps
- Does not send unsolicited communications to end users
- Handles data deletion when an org uninstalls the app
Prohibited Content
Apps must not:
- Contain malware, spyware, or malicious code
- Collect data beyond what is needed for stated functionality
- Share org data with third parties without explicit consent
- Interfere with the LendWorks platform or other apps
- Violate any applicable laws or regulations
- Include misleading descriptions or fake reviews
- Attempt to circumvent rate limits or API restrictions
Pricing Guidelines
If your app charges users:
- Clearly state pricing before installation
- Support a free trial of at least 7 days (recommended)
- Handle billing outside of LendWorks (we do not process payments on behalf of apps)
- Do not gate features that were promised as included
Update Policies
After your app is listed:
- Minor updates (bug fixes, UI tweaks, description changes) take effect immediately
- Scope changes require a new review cycle
- Breaking changes must be communicated to installed users at least 14 days in advance
- Deprecation — If you plan to discontinue your app, notify users at least 30 days before delisting
Review Timeline
| Stage | Duration |
|---|---|
| Initial submission to review start | 1–2 business days |
| Review | 3–5 business days |
| Changes requested to resubmission | Depends on you |
| Resubmission review | 1–3 business days |
Tips for a Smooth Review
- Test thoroughly in the sandbox before submitting
- Document your scopes — Explain why each scope is needed in the review questionnaire
- Provide test credentials if your app requires external service accounts for review
- Keep it simple — Apps with focused functionality and minimal scopes are reviewed faster
- Be responsive — If the review team requests changes, respond promptly to avoid delays