Skip to main content
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. This guide covers how to:
  • Start a new Marketplace listing
  • Submit your listing for review
  • Understand the review process and timeline
  • Know who can manage and delete a listing
Only public connections with an installation scope of Any workspace can be listed on the Marketplace. Internal connections and OAuth integrations limited to selected workspaces aren’t eligible. Installation scope is set when the connection is created and can’t be changed afterward — see Installation scope.

Start a new listing

2
In the Listings section of the sidebar, select Connections.
3
Under Drafts, select Publish a connection.
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.
You can also start from the Developer portal. Open the public connection’s Configuration tab and select Publish to Marketplace next to Marketplace listing. After the connection has a listing, the same place shows its status and a Manage listing link.

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. Track the status of your submission from the Listings > Connections page in the Marketplace listing dashboard. See the FAQ below for review timelines. If approved, the listing appears in the Notion Marketplace. If changes are required, the Notion team sends feedback and you can resubmit after making updates.

Who can manage a listing

To publish a connection, you need to be one of its connection owners and an owner or admin of your Marketplace profile. If more than one person owns the connection, any of them can start a draft from their own Marketplace profile. The listing belongs to the Marketplace profile whose submission the Notion team approves. Drafts and rejected submissions don’t reserve the connection. After a listing is approved, only that profile can edit or resubmit it, and other profiles don’t see Manage listing in the Developer portal. You can’t edit a listing while its submission is waiting for review. If you need to change something, wait for the Notion team’s response. To delete a connection that has a listing, you need to be a connection owner and an owner or admin of the Marketplace profile that published the listing. Deleting the connection also removes its listing from the Marketplace. If the connection’s first submission is still waiting for review, any connection owner can delete it. 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. Check the status of your connection submission from the Listings > Connections page in the Marketplace listing dashboard.
The Notion team sends an email explaining why your listing was not approved. 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