Esc

↑↓ move↵ openIndex · Pagefind
Admin and security / Company settings

Company settings

What each Company Admin section does, from members and projects to stages, offices, trades, webhooks and sample data, plus your own account settings in My Profile.

On this page

Company Admin holds the settings that apply to the whole company: who has access and at what level, the lists every project draws from, and integrations. Your own profile, password, two-factor and notification settings are in My Profile, covered at the end of this page.

Open Company Admin

Company Admin lives at app.os.construction/companies/<your company>/admin. Only company admins can open it; anyone else gets a “not found” page. A searchable sidebar lists every section, grouped as People & access, Projects, Organization, Workflows, Data and Integrations.

Overview

The first page, Overview, shows counts across the top: Active members (with the number of company admins), Projects (with the number archived), Templates, Pending invites and Insurance. If any insurance policies are expired or expiring, a notice links to Review compliance. Below that, every section is listed with its description and record count.

People & access

Section What it’s for Guide
Members Who can sign in, who is a company admin, company CRM access, and each person’s project templates. Make admin, Deactivate and Add to project are here. Invite your team
Invitations One-time account links for new members, and their status. Invite your team
Permission Templates Reusable sets of tool access levels you assign to project members. Set up permission templates
SCIM Let your identity provider create, update and deactivate members. SCIM provisioning

Projects

Projects: create, archive and restore

Company Admin → Projects lists every company project on two tabs, Active and Archived. Each row shows the project number, stage, type and city.

  • New project opens the new project form. See Your first project.
  • Archive takes a project out of everyone’s project list. All of its records are kept.
  • On the Archived tab, Restore brings it back, at any time.
  • Select a project’s name to open its Admin tool.

Project Stages, Types and Regions

These are the lists you pick from when you set up a project, and that lists and portfolio reports group by.

Section What it holds Fields
Project Stages The lifecycle stages a project moves through, from pursuit to closeout. Name, and a Formatted name that lists and reports display.
Project Types Categories such as healthcare, retail or multifamily. Name, Active.
Project Regions Geographic regions used to group projects in lists and portfolio reporting. Name, Active.

Each works the same way: fill in the New … panel at the top and select Create …, edit a row and select Save …, or remove it with Delete …. Project types and regions also have an Active checkbox, so you can retire one without deleting it.

Organization

Section What it holds Fields
Offices Company offices and branch locations. Mark the headquarters as the main office. Name, Address, City, State / region, Country, ZIP / postal, Phone, Fax, Division, Main office, Active
Trades Trades that classify companies in your directory, bids and commitments. Name, optional Code and CSI code, Active
Departments Internal departments people belong to, such as Estimating or Field Operations. Name, Description, Active
Insurance Insurance policies, certificate evidence, review and renewal follow-ups. See Insurance and COIs

An inactive department stays on existing records but can no longer be picked. Offices, trades and departments are created, saved and deleted the same way as stages.

Workflows: Approval workflows

Approval workflows holds your company’s multi-step approval policies for change orders, pay applications, purchasing, AP and more, with starter templates, a visual designer and a simulator. See Approval workflows.

Data: Sample data

New trial workspaces start with a sample construction company: the Riverside Medical Center job in progress, 13 more jobs, sample accounting books, a CRM pipeline and Analytics dashboards. Every sample record is marked, so you can remove all of it when you’re ready to go live. Your own projects, records and settings are never touched.

Company Admin → Sample data shows the sample’s status (Preparing, Ready, Incomplete, Removing or Removed), the number of Sample projects, Company sample records (books, CRM, people, firms), the sample’s Data date (its “today”), and links to each sample project.

Remove sample data

  1. Open Company Admin → Sample data

    Under Data, pick Sample data.

  2. Confirm

    In the Remove sample data panel, type REMOVE SAMPLE DATA in the confirmation box.

  3. Select Remove sample data

    The page reports how many sample records and sample projects were removed.

Removal deletes the sample projects and every sample record: the accounting books (journal entries, bills, invoices, payroll, bank activity), the CRM pipeline, Analytics dashboards, the sample people and firms, and the files the sample stored (unless one of your own records still uses them). It can’t be undone.

You can’t remove the sample while it is still being prepared. A new workspace prepares it in the background in the first minutes after signup, and the page updates by itself.

Prepare sample data again

If preparing the sample failed (status Incomplete) or stalled, the page shows Prepare sample data again. Select it to start over; partial sample records are cleared first, so nothing is doubled. Or remove what was created instead.

Integrations: Webhooks

Company Admin → Webhooks sends signed HTTP deliveries to your own systems when project records, Accounting, CRM or Analytics events happen. The event names are listed in the webhooks developer guide.

  1. Create a subscription

    Under Create subscription, enter a Destination URL. Under Events, tick the project record events you want (grouped by record type), and type any others in Other events as a comma-separated list: webhook.test, accounting.*, crm.*, analytics.*, or * for everything. Leave Signing secret blank to have one generated. Add a Description if you like, keep Active ticked, and select Create subscription.

  2. Send a test

    Pick the subscription in Subscriptions and select Send test. Tests run through the company job queue; select Run company jobs to process it now, then reload.

  3. Check Delivery history

    Each delivery shows its outcome, the number of attempts, the HTTP status and any error. Expand Latest attempts for timestamps. A failed delivery can be retried with Retry delivery, and a past delivery can be sent again with Replay.

You can also Save subscription, Rotate signing secret or Delete subscription. A delivery may repeat after a connection failure, so deduplicate by event_id on your side.

Your account: My Profile

Everyone, not just admins, has My Profile at app.os.construction/account. Open it from the account menu (your initials, top right) → My Profile. The page has four sections:

  • Profile: First Name, Last Name, Initials, Job Title, Business Phone, Cell Phone, Locale and an Avatar URL. Select Save Profile. Your login email can’t be changed here; ask an administrator.
  • Password: Current Password, New Password (at least 8 characters) and Confirm New Password, then Change Password.
  • Two-factor: set up or turn off an authenticator app. See Two-factor sign-in and account security.
  • Notifications: for each event, tick In-App and Email, then Save Preferences. These apply across every project.

The section bar on My Profile also links to AI assistants, where you connect Claude, ChatGPT and other assistants to your workspace. See Connect AI assistants.

Keep exploring

Related across os.construction

Run it on your own project.

Start a 14-day free trial. Want a say in what ships next? Join the founding program.

Your role (optional)

14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →

Ask the OS

Reading this page

Ask anything about this page. Answers use what you're reading as context.

Suggested

    AI · may be imperfect · sample data where shown

    Open file