---
title: Quickstart
description: Set up your workspace and publish your first posts
---

Get Firmreader running for your team in three steps.

## 1. Create your workspace

Sign up at [firmreader.com](https://firmreader.com) and choose a workspace name. This becomes your team's URL: `yourcompany.firmreader.com`.

<Note>
Workspace names must be lowercase, alphanumeric, and between 3-32 characters.
</Note>

## 2. Invite your team

Go to **Settings > Team Members** and invite people by email or connect your identity provider for SSO.

| Method | How it works |
|--------|-------------|
| Email invite | Send individual or bulk invitations |
| SSO | Connect Google Workspace, Okta, or Azure AD |
| Domain auto-join | Anyone with your company email domain can join automatically |

## 3. Publish your first post

<Steps>
  <Step title="Create a channel">
    Navigate to **Channels > New Channel**. Give it a name like "Company News" and set the visibility to your entire organization.
  </Step>
  <Step title="Write a post">
    Click **New Post**, select your channel, and use the rich text editor to write your announcement. Add images, links, and formatting as needed.
  </Step>
  <Step title="Publish">
    Hit **Publish** to send it immediately, or click **Schedule** to set a future date and time.
  </Step>
</Steps>

Your team will receive a notification based on their preferences — push notification, email digest, or in-app alert.

## Install the apps

Firmreader is available on every platform:

<CodeGroup>
```text iOS
Download from the App Store
Search "Firmreader" or scan the QR code in your workspace settings
```

```text Android
Download from Google Play
Search "Firmreader" or scan the QR code in your workspace settings
```

```text Desktop
Download from firmreader.com/download
Available for macOS, Windows, and Linux
```
</CodeGroup>

## Use the API

For teams that want to automate publishing or integrate with existing workflows:

```bash
curl -X POST https://api.firmreader.com/v1/posts \
  -H "Authorization: Bearer fr_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "ch_company_news_id",
    "title": "Welcome to Firmreader",
    "body": "We are excited to announce our new internal communications platform.",
    "priority": "normal"
  }'
```

<Tip>
Get your API key from **Settings > API Keys** in your workspace dashboard.
</Tip>

## Next steps

<Columns cols={2}>
  <Card title="Channels" icon="layer-group" href="/features/channels">
    Organize content for your team.
  </Card>
  <Card title="Admin Setup" icon="gear" href="/configuration">
    Configure branding, permissions, and integrations.
  </Card>
</Columns>