Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

The Notion Marketplace is how Notion users discover and connect public connections. Listing your connection there puts it in front of every Notion user — and it’s a separate step from building the connection itself, so you can ship whenever you’re ready. This guide assumes you already have a public connection. If you haven’t created one yet, see the Public connections guide first. In this guide, you’ll learn how to:
  • Start a new Marketplace listing
  • Submit your listing for review
  • Understand the review process and timeline
Only public connections with an installation scope of Any workspace can be listed on the Marketplace. Internal connections and Selected workspaces only public connections are not eligible. Installation scope is set when the connection is created and can’t be changed afterward — see Installation scope.

​
Start a new listing

1
Navigate to the Creator dashboard.
2
In the Listings section of the sidebar, select Connections.
3
Under Drafts, click Start a new connection listing.
4
Fill in the listing details, including:
  • Listing name and description
  • Category and tags
  • Listing images and logo
  • The public connection to associate with this listing
5
Save your listing as a draft. You can return to edit it at any time before submitting.

​
Submit for review

When your listing is ready, submit it for review from the Connections listing page.
1
From the Listings > Connections page, find your draft listing.
2
Review all listing details to ensure they are complete and accurate.
3
Submit your listing for review by the Notion team.
After submission, your listing moves to the Submitted section where you can track its review status.

​
Review process

The Notion team reviews every listing submission. You can track the status of your submission from the Listings > Connections page in the Creator dashboard. See the FAQ below for review timelines. If your listing is approved, it will appear in the Notion Marketplace. If changes are required, you will receive feedback and can resubmit after making updates. For guidance on the review process and best practices to get your connection approved, check out the Notion Connection Gallery Best Practices guide.

​
Frequently asked questions

After submission, expect to hear back from our team within 5-10 business days via email. You can also check the status of your connection submission from the Listings > Connections page in the Creator dashboard.
You’ll receive an email notification from our team explaining why your listing was not approved. You can also check the status from the Listings > Connections page.
Connections are rejected for various reasons, from brand/trademark issues to quality concerns to situations where the baseline connection criteria isn’t met. We encourage developers to review our feedback, make necessary changes, and resubmit. Our goal is to help you create high-quality and valuable tools for the Notion community.
No. Public connections work independently of Marketplace listings. Listing on the Marketplace is optional and helps your connection reach a wider audience, but your connection can be used via its OAuth flow without being listed.

Notion Developers

Overview

Create connections with the Notion API

Authorization guide