Hey there! Over the last few weeks the Notehub team has shipped a batch of features to help Notehub administrators manage their users and projects.
These updates are especially useful for teams that have multiple people working across multiple Notehub projects. You now have more visibility into who can access your projects, better tools for onboarding and offboarding users, a simpler way for admins to request project access, and updated APIs that match the new terminology in the Notehub UI.
In this blog post we’ll go over all the changes, starting with the new Organization section and where you can find these features in Notehub.
Say Hello to Organizations
Let’s start with the biggest change you’ll notice in Notehub: the section previously called Billing Account is now called Organization. You’ll find it in your profile menu, as shown in the screenshot below.
This is still the home for managing your members, projects, plan and billing details, and contact information—we just gave it a name that better reflects its role as the administrative home for your organization in Notehub.
The rest of this post covers the new capabilities we’ve added inside that Organization section.
See Your Organization’s Guests
The first new feature is a Guests listing, which you’ll find as a tab on your Members page.
So what’s a guest? Your Members page shows the people who belong to your organization directly. But over time it’s common to end up with people who can access one or more of your organization’s projects without ever being a member of the organization itself—a contractor you invited to a single project, for example, or a teammate who was added to one project but never to the org.
The Guests page surfaces exactly those people. It lists everyone who has access to at least one of your organization’s projects but doesn’t hold an organization-level role.
For each guest you’ll see their name and email, the number of projects they can access (click through to see the specific projects and the role they hold on each), their status, who invited them, and when they joined. The status is either Active, meaning they’ve accepted and currently have access, or Invited, meaning they have a pending invitation to a project but haven’t accepted it yet.
Using the triple-dot menu on the right (see screenshot below), you can also Block Access to guests, which removes their access to the organization and all projects within.
Reserve Your Domain Names
Next, organization admins can now reserve a domain name—for example, yourcompany.com. Once a domain is reserved, you also choose to automatically add new Notehub users with email addresses that match your domain.
You can request a domain from your Organization’s Overview page. Along with the domain itself, you can provide a reason for the request, choose whether matching users should be added automatically, and configure the default role those users should receive.
A few details worth knowing about how this works under the hood:
-
Reservations are reviewed before they take effect. Reserved domains go through the same approval process we use for reserving a ProductUID prefix. When you submit a request, Notehub notifies our team, and the domain only becomes active once it’s granted. This prevents one organization from claiming a domain that belongs to another.
-
Matching is smart about subdomains. If a user signs up with an address at a subdomain of your reserved domain, Notehub matches them to the most specific reservation that applies, so you don’t have to enumerate every possible subdomain yourself.
-
The automatic-add behavior only works for brand-new accounts as they validate their email addresses. Reserving a domain doesn’t pull in users who already have existing Notehub accounts—so you’ll have to invite those users to your organization the usual way.
Request Access to Projects
Next, organization admins now have the ability to request access to projects. Project access is granted per project, so it’s entirely possible for a project to exist in your org that you can’t actually open.
On your organization’s Projects page you can now see these projects and request access with the Request Access button.
After your request, Notehub emails that project’s admins to let them know you’d like access, and they can approve the request from there.
API Changes
Finally, to match the rename in the UI, the Notehub Billing Account APIs are now Organization APIs. If you’re building automations against Notehub, you’ll want to migrate to the new organization endpoints.
- Get Billing Accounts → Get Organizations
- Get Billing Account → Get Organization
- Get Billing Account Balance History → Get Organization Balance History
The new endpoints are functionally equivalent to the previous Billing Account API endpoints, so migration should be as easy as updating the URLs you call, for example /billing-accounts → /organizations.
The previous Billing Account API endpoints are now deprecated. They’ll continue to function for now, but we plan to remove them in a release later this year.
Wrapping Up
That’s the rundown of what’s new for Notehub administrators: a renamed Organization section, a Guests page for seeing who can reach your projects, reserved domain names for automatic onboarding, the ability to request access to projects, and the new Organization APIs.
Give these a shot on your own organization, and as always—if you have feedback, requests, or ideas for what we should build next, let us know in our community forum.
