NUMU Docs
Contact
APIThemesPartner Apps
APIThemesPartner Apps
  1. Partner Apps
  • 🧩 Partner apps
  • Join the partner program
  • Register your app
  • App manifest
  • OAuth and app tokens
  • App webhooks
  • Review and publishing
  • The numu CLI
  • Build with an AI assistant
  • Troubleshooting apps
  1. Partner Apps

Join the partner program

Private beta
The program opens by invitation for now. While it is closed, the portal says "The Partner program isn't open yet" and the partner API answers 404. To ask for an invitation, write to engineering@numueg.app.

1. Create a NUMU account#

1.
Open merchant.numueg.app and choose Create Account. Besides your email and password, NUMU asks for a phone number.
2.
Open the email NUMU sends you and verify your address. You cannot apply until it is verified.
You don't need a store of your own to become a partner. If the dashboard asks you to create one, go straight to the portal instead.

2. Open the partner portal#

Go to merchant.numueg.app/partners.
If you already run a store on NUMU, you can also click your store's card at the bottom of the sidebar, then Partner program.

3. Apply#

Fill in Apply to become a partner:
FieldRequiredNotes
You areYesAn individual developer or A company
Public nameYesMerchants see it on your apps and on the consent screen
Legal nameNoThe name on the agreement. A company should fill it in
Support emailYesMerchants contact you here about your apps
Support phoneNo
WebsiteNoA full URL that starts with https://
Tick I accept the NUMU Partner Agreement and the App Review Guidelines, then choose Send application.

4. Wait for the decision#

NUMU reviews every application by hand and emails you the answer. The portal shows where you stand:
The portal saysMeans
Your application is under reviewPending. It cannot be edited while it waits
Your application wasn't approvedRejected. NUMU's notes say why. Fix it and apply again from the same page
You're a NUMU partnerApproved. You can create development stores and apps
Your partner account is suspendedYou cannot create stores or submit work until NUMU lifts the suspension
When NUMU publishes a new version of the Partner Agreement, the portal says The Partner Agreement changed, with an Accept version … button. Until you accept it, you cannot create development stores or change your apps.

Development stores#

A development store is a free test store you own. It has API access, it never takes real orders, and search engines never see it. An app that is not published yet installs only on its own partner's development stores.
In the portal, under Development stores:
Create: enter a Store name and a Subdomain (lowercase letters, digits and dashes), then choose Create store. The store lives at <subdomain>.numueg.app. You can have up to 5.
Add sample data: fills the store with sample data to test against, once per store.
Visit storefront opens the shop. Open in dashboard switches the dashboard to that store.
The storefront of a development store shows a "development store" banner, so no shopper mistakes it for a real shop.

Find the id of a development store#

The install flow needs your development store's id, and the portal does not show it yet. Read it through the API:
1.
Choose Open in dashboard on the store.
2.
Go to Settings → API & webhooks and create a key with one read scope, such as catalog:read.
3.
Ask the API who the key belongs to:
data.store_id is the id.
4.
Delete the key.

Next#

Register your app, step by step.
Modified at 2026-09-24 14:17:29
Previous
🧩 Partner apps
Next
Register your app
Built with