Skip to main content
{headless}
Dashboard
Core ConceptsOrganizations2 min read

Organizations

Organizations are the top-level container for all your projects and team members.

Creating an Organization

  1. Click Create Organization from the dashboard
  2. Enter an organization name
  3. Choose a unique URL slug (e.g., my-company)
  4. Click Create

Managing Members

  1. Navigate to your organization's Settings > Members
  2. Click Invite Member
  3. Enter the user's email address
  4. Select a role:
    • Owner: Full access, can delete organization
    • Admin: Can manage projects and members
    • Editor: Can create and edit content
    • Viewer: Read-only access
  5. Click Send Invitation

The invitee receives an email. If they already have a Headless account, the link takes them to sign in, and signing in (or opening the organization while already signed in) accepts the invitation. If they are new, the link takes them to a Set up your account page where they create a password; completing it activates the account and accepts the invitation in one step, so they can sign in immediately. Setup links last 7 days. If one expires, the invitee can request a fresh link from Forgot password, or an admin can use Resend on the pending invitation.

Organization Settings

Access organization settings through the sidebar:

  • General: Update name, slug, and logo
  • Members: Manage team members and invitations
  • Billing: View current plan and usage statistics
  • Data: Export, import, or delete organization data

Role Permissions

ActionViewerEditorAdminOwner
View content
Create entries
Edit entries
Delete entries
Manage content types
Manage API keys
Manage webhooks
Invite members
Change member roles
Delete project
Delete organization

Removing Access

  1. Go to Organization Settings > Members
  2. Find the user to remove
  3. Click the menu icon (⋮)
  4. Select Remove from Organization

Audit Logs

Organization owners and admins can view audit logs:

  1. Click Audit Logs in the organization sidebar
  2. View a history of all actions taken in the organization
  3. Filter by action type, date range, or user
  4. Use audit logs for compliance and security monitoring