{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"slack/app-and-directory","name":"Slack app and Slack Marketplace listing","vendor":"Slack (Salesforce)","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Create a Slack app in a development workspace, add scopes, install it and copy its tokens and signing secret. To offer it to other workspaces, activate public distribution; to list it in the Slack Marketplace (formerly the App Directory) it needs 10+ active workspaces and passes a preliminary and a functional review.","account_model":{"summary":"A Slack app is created by a Slack user and belongs to a development workspace (Enterprise org admins may also have to approve installs). Each workspace that installs the app gets its own bot/user tokens via OAuth. Marketplace listing is a separate review on top of public distribution.","accounts":[{"name":"Slack user in a development workspace","kind":"personal","owned_by":"the person","required":true,"note":"Creates and manages the app at api.slack.com/apps."},{"name":"Development workspace","kind":"organisation","owned_by":"the company","required":true,"note":"The workspace the app is developed and first installed in."},{"name":"Slack app","kind":"developer","parent":"Development workspace","required":true,"note":"Holds client id/secret, signing secret, scopes, and per-install tokens."}],"notes":["Commercially distributed apps outside the Marketplace (\"unlisted\") get much lower rate limits on conversations.history and conversations.replies."]},"prerequisites":[],"identity_requires":[],"have_ready":[{"kind":"live_website","description":"A public landing page made for the Slack app (overview, how it works, install path, next steps, privacy link)","why":"Required for a Marketplace listing; PDFs and repo links are not accepted.","needed_for":["submit-marketplace"],"auto_check":"website_live","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-app-guidelines-and-requirements"},{"kind":"app_privacy_policy_url","description":"Privacy policy covering data collected, use, retention, access/deletion requests and a contact email or webform","why":null,"needed_for":["submit-marketplace"],"auto_check":"website_live","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-app-guidelines-and-requirements"},{"kind":"domain_email","description":"Public support contact (email or form) able to respond within 2 business days","why":null,"needed_for":["submit-marketplace"],"auto_check":"none","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-app-guidelines-and-requirements"},{"kind":"demo_video","description":"Video showing installation, OAuth, setup, end-to-end use and uninstall (plus optional 30-90 s public YouTube listing video)","why":null,"needed_for":["submit-marketplace"],"auto_check":"none","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-review-guide"},{"kind":"other","description":"Test account credentials with dummy data for any third-party service the app uses","why":null,"needed_for":["submit-marketplace"],"auto_check":"none","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-review-guide"},{"kind":"other","description":"At least 10 active workspaces using the app in the past 28 days","why":"Apps below this cannot submit to the Marketplace.","needed_for":["submit-marketplace"],"auto_check":"none","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-review-guide"},{"kind":"other","description":"Screenshots 1600 x 1000 px (8:5), JPG/PNG under 2 MB, and a short description of 10 words or fewer","why":null,"needed_for":["submit-marketplace"],"auto_check":"none","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-app-guidelines-and-requirements"}],"steps":[{"id":"sign-in","title":"Sign in to Slack in your development workspace","summary":"Sign in yourself to the workspace where you will build the app.","route":"guided","gate":"human_login","human_only":true,"gate_label":"You sign in","depends_on":[],"optional":false,"url":"https://api.slack.com/apps","lead_time":null,"preflight":[],"captures":null},{"id":"create-app","title":"Create the app","summary":"At api.slack.com/apps choose Create an app, give it a name and pick the development workspace, then press Create.","route":"copilot","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["sign-in"],"optional":false,"url":"https://api.slack.com/apps","lead_time":null,"preflight":[],"captures":null},{"id":"scopes-install","title":"Add scopes and install to the workspace","summary":"Under OAuth & Permissions add only the bot scopes you need (user scopes only if acting as a user), then Install to Workspace and Allow. Reinstall after adding scopes.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["create-app"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":"SLACK_BOT_TOKEN"},{"id":"signing-secret","title":"Copy the signing secret and client credentials","summary":"From Basic Information copy the Signing Secret (to verify incoming requests) and, for OAuth distribution, the Client ID and Client Secret.","route":"guided","gate":"none","human_only":false,"gate_label":null,"depends_on":["create-app"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"public-distribution","title":"Activate public distribution (optional)","summary":"Under Manage Distribution complete the checklist (OAuth redirect URL, HTTPS on all request URLs) and Activate Public Distribution to get an Add to Slack button.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["scopes-install"],"optional":true,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"submit-marketplace","title":"Submit to the Slack Marketplace (optional)","summary":"Once the app is public, fully working and in 10+ active workspaces, submit it for review with the landing page, privacy policy, support details, test credentials, scope justifications and demo video. You press submit.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["public-distribution"],"optional":true,"url":null,"lead_time":{"official":{"text":"Preliminary review up to 10 business days; functional review up to 10 weeks for new submissions (6 weeks for updates to published apps). Reviews cannot be expedited.","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-review-guide","source_title":"Slack Marketplace review guide"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null},{"id":"changes-after-listing","title":"Ship changes to a listed app","summary":"A live listed app is locked. New functionality or scopes need resubmission with a video and a staging app; display info and pricing changes do not.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["submit-marketplace"],"optional":true,"url":null,"lead_time":{"official":{"text":"Up to 6 weeks functional review for published apps resubmitting changes.","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-review-guide","source_title":"Slack Marketplace review guide"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null}],"gates":[{"step":"sign-in","gate":"human_login","label":"You sign in"},{"step":"create-app","gate":"human_submit","label":"You press submit"},{"step":"scopes-install","gate":"human_submit","label":"You press submit"},{"step":"public-distribution","gate":"human_submit","label":"You press submit"},{"step":"submit-marketplace","gate":"third_party_review","label":"The provider reviews it"},{"step":"changes-after-listing","gate":"third_party_review","label":"The provider reviews it"}],"lead_times":[{"step":"submit-marketplace","what":"Submit to the Slack Marketplace (optional)","official":{"text":"Preliminary review up to 10 business days; functional review up to 10 weeks for new submissions (6 weeks for updates to published apps). Reviews cannot be expedited.","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-review-guide","source_title":"Slack Marketplace review guide"},"reported":null},{"step":"changes-after-listing","what":"Ship changes to a listed app","official":{"text":"Up to 6 weeks functional review for published apps resubmitting changes.","source_url":"https://docs.slack.dev/slack-marketplace/slack-marketplace-review-guide","source_title":"Slack Marketplace review guide"},"reported":null}],"outputs":[{"name":"SLACK_BOT_TOKEN","description":"Bot user OAuth token for the installed workspace","secret":true,"example_format":"xoxb-…","environments":null},{"name":"SLACK_SIGNING_SECRET","description":"Signing secret used to verify requests from Slack","secret":true,"example_format":null,"environments":null},{"name":"SLACK_CLIENT_ID","description":"App client id for the OAuth install flow","secret":false,"example_format":null,"environments":null},{"name":"SLACK_CLIENT_SECRET","description":"App client secret for the OAuth install flow","secret":true,"example_format":null,"environments":null},{"name":"SLACK_APP_TOKEN","description":"App-level token (only for Socket Mode and similar features)","secret":true,"example_format":"xapp-…","environments":null}],"renewals":[],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/slack/app-and-directory"}