# Set up your workspace (/docs/getting-started/set-up-workspace)

Right after you confirm your email, Mokanata walks you through four steps: create your workspace, connect your first channel, invite your team and create your first agent. Only the first one is required. You can skip the rest and come back to them from the Command center (see [Finish setup later](/docs/getting-started/setup-checklist)).

- **Who can use it:** The person who signs up and creates the workspace. They become its **Owner**. People who join through an invite skip setup, because the workspace already exists.
- **Before you start:** A confirmed account ([Create your account](/docs/getting-started/create-account)). For the channel step, the login for that channel (for WhatsApp, the business number registered for the WhatsApp Business API). For the invite step, your teammates' email addresses.

## How setup works [#how-setup-works]

The top of every step shows "Setting up Mokanata for" with your first name, and four steps across the page. The current step has a blue bar, finished steps a dark bar and a check mark, and skipped steps a skip mark. Once your workspace exists, you can click any step to go back to it. On a phone, the steps show as "Step 1 of 4".

![Setup's first step: Setting up Mokanata for Alex, the four steps Create your workspace, Connect a channel, Invite your team and Create your first agent, and the Create your workspace form with Acme Labs filled in](/screenshots/set-up-workspace/01-workspace.webp)

To stop and continue another time, click **Log out** at the top right. If you haven't created your workspace yet, you're back on step 1 the next time you log in. Once it exists, you land on the Command center, where the steps you haven't finished wait on a checklist.

## Step 1: Create your workspace [#step-1-create-your-workspace]

<Steps>
<Step>

### Name your workspace [#name-your-workspace]

**Workspace name** is filled in from your email: a company address like {'alex@acme-labs.io'} gives "Acme Labs", and a personal address (Gmail, Outlook and similar) gives "Alex's team". Change it to your company or team name, up to 60 characters. You can rename it later in [Settings → Workspace](/docs/settings/workspace).

</Step>
<Step>

### Check the workspace address [#check-the-workspace-address]

**Workspace address** is your workspace's web address, app.mokanata.com/ followed by what you type. It follows the name until you edit it yourself. Use 3 to 40 lowercase letters, numbers and single dashes. Mokanata checks it as you type: a check mark and "is available" when it's free, or "is taken. Try another." when another workspace uses it.

![The Workspace address field in red with app.mokanata.com/northwind and the message app.mokanata.com/northwind is taken. Try another](/screenshots/set-up-workspace/02-address-taken.webp)

</Step>
<Step>

### Pick your team size and create it [#pick-your-team-size-and-create-it]

Under **How many people will use Mokanata?** choose **Just me**, **2–10**, **11–50**, **51–200** or **201+**, then click **Create workspace**. You become the workspace's owner, on the plan you picked when you signed up (Free if you didn't pick one). The next step confirms it, for example "Acme Labs is ready."

</Step>
</Steps>

If you'd rather not decide now, click **Skip, use a default name**. Mokanata creates a workspace named after you ("Alex's workspace"), marks the step as skipped and says so on the next step: "Created “Alex's workspace”. Rename it any time in Settings → Workspace." Saving a new name there marks the step done.

## Step 2: Connect your first channel [#step-2-connect-your-first-channel]

<Steps>
<Step>

### Choose a channel [#choose-a-channel]

Pick where most of your customers write to you. **WhatsApp**, **Facebook** and **Instagram** connect with Facebook; they go live once Mokanata's Meta app is approved. The other cards are channels that are coming soon: each says it isn't available yet, and you can't connect it. Agents start in shadow mode, so connecting a channel doesn't send anything.

![The Connect your first channel step with a card per channel, WhatsApp selected, and the Connect WhatsApp panel below](/screenshots/set-up-workspace/03-channel.webp)

</Step>
<Step>

### Sign in with Facebook [#sign-in-with-facebook]

The panel under the cards lists what you allow: read new messages, send replies that you or your agents' rules approve, and receive delivery and read receipts. Click **Continue with** followed by the channel's name.

- For **WhatsApp**, Meta's sign-up opens: pick your business account and number (see [Add a WhatsApp number](/docs/channels/whatsapp-numbers)). The next step reminds you to register the number with its two-step PIN in Setup → Channels before agents send from it.
- For **Facebook** or **Instagram**, sign in with Facebook and switch on the Pages and Instagram accounts agents reply from (see [Connect a channel](/docs/channels/connect-a-channel)).

The next step confirms it, for example "Instagram connected. New conversations will show up in your inbox."

</Step>
</Steps>

You can connect the other channels later from **Setup** (see [Connect a channel](/docs/channels/connect-a-channel)). **Skip for now** moves on without connecting one.

## Step 3: Invite your team [#step-3-invite-your-team]

<Steps>
<Step>

### Add email addresses [#add-email-addresses]

Type a teammate's **Email** in each row and pick their **Role**: **Admin**, **Member** (the default) or **Viewer**. The legend under the rows says what each role does. **Add another** adds a row (up to 10 at a time); the bin button removes one.

Mokanata checks each address as you type, and tells you if it's yours, already in the list or already in the workspace.

![The Invite your team step with jordan@acme-labs.io as Member and noor@acme-labs.io as Admin, the role legend for Admin, Member and Viewer, and the Send 2 invites button](/screenshots/set-up-workspace/05-invite.webp)

</Step>
<Step>

### Send the invites [#send-the-invites]

Click **Send invite** (or **Send 2 invites**, and so on). Each person gets an email with a link to join; invites last 7 days. Inviting the same address again replaces their earlier invite. See [Accept an invite](/docs/getting-started/accept-invite) for what your teammates see.

</Step>
</Steps>

Owners can't be invited: invite someone as an admin, then transfer ownership if you need to. Manage invites later in [Settings → Members & roles](/docs/settings/members). **Skip for now** moves on without inviting anyone.

## Step 4: Create your first agent [#step-4-create-your-first-agent]

<Steps>
<Step>

### Pick a starting point [#pick-a-starting-point]

The step explains how an agent's autonomy grows: **Shadow** (it drafts and sends nothing), **Approve** (drafts wait in your queue) and **Autonomy** (it sends on its own under your rules). Under **Start from**, choose **Sales closer**, **Support triage**, **Renewal watch** or **Start from scratch**.

![The Create your first agent step with the Shadow, Approve and Autonomy strip, the Start from choices with Sales closer selected, and the Open the agent wizard button](/screenshots/set-up-workspace/06-agent.webp)

</Step>
<Step>

### Finish the agent in the wizard [#finish-the-agent-in-the-wizard]

Click **Open the agent wizard**. The wizard opens with a banner, "Setup · Step 4 of 4", and walks you through the agent's channels, knowledge and guardrails (see [Create an agent](/docs/agents/create-agent)). An agent deployed from setup always starts in shadow mode.

![The agent wizard with the setup banner Setup · Step 4 of 4, Create your first agent. It starts in shadow mode, and a Skip for now button](/screenshots/set-up-workspace/07-wizard-banner.webp)

When you deploy it, Mokanata says the agent is in shadow on its channels, marks the step done and opens the setup summary. To leave the wizard without an agent, click **Skip for now** in the banner.

If you leave the wizard another way after making changes, Mokanata asks **Leave without deploying?**: **Discard draft**, **Keep editing**, or **Leave, keep draft** (the draft stays until you reload the page or log out). If the agent deploys but setup can't record it, the banner says the agent is deployed in shadow and offers **Finish setup**.

</Step>
</Steps>

## Finish setup [#finish-setup]

The last page sums up the four steps, each **Done**, **Skipped** or **Not started**.

- When all four are done, it reads **You're all set**.
- When some are open, it reads **You're in. A few steps are waiting**, with **Start** or **Resume** next to each open step.

Click **Open the Command center** to start working. Open steps wait on the Command center's checklist and under **Finish setup** in your account menu (see [Finish setup later](/docs/getting-started/setup-checklist)).

![The setup summary You're in. A few steps are waiting, with Create your workspace, Connect a channel and Invite your team done, Create your first agent skipped with a Resume button, and Open the Command center](/screenshots/set-up-workspace/08-summary.webp)

## Go back to a finished step [#go-back-to-a-finished-step]

Click a finished step at the top to see what you set up. Each one shows a summary and **Continue**, with more in the **⋯** menu:

| Step | What it shows | In the ⋯ menu |
|---|---|---|
| Create your workspace | **Your workspace is ready**: name, address and team size. After a skip, **Keep this name** marks it done. | **Rename in Settings** |
| Connect a channel | The connected channel, marked **Healthy**. | **Manage channels** |
| Invite your team | The invites still waiting, with their roles, or "Everyone you invited has joined." | **Invite more people** |
| Create your first agent | **Your first agent is in shadow**: "Deployed in shadow mode." | **See your agents** |

![The revisited first step: Your workspace is ready, with Name Acme Labs, Address app.mokanata.com/acme-labs, Team size 2–10, a Continue button and a more actions menu](/screenshots/set-up-workspace/09-step-done.webp)

## Troubleshooting [#troubleshooting]

<Accordions type="single">
<Accordion title="The workspace address is taken">

Every workspace address is unique. Add your city, product or a short word (for example `acme-labs-eu`). You can change the address later in [Settings → Workspace](/docs/settings/workspace).

</Accordion>
<Accordion title="It says an invited address is already in the workspace">

That person already joined. Change their role in [Settings → Members & roles](/docs/settings/members) instead of inviting them again.

</Accordion>
<Accordion title="A step still shows Skipped">

If you connected a channel or invited people outside setup, the checklist doesn't notice: it only ticks steps you finish from setup itself. Open the step from the checklist or your account menu and finish it there, or hide the checklist once you've done everything (see [Finish setup later](/docs/getting-started/setup-checklist)).

</Accordion>
</Accordions>

## Next steps [#next-steps]

<Cards>
<Card title="Finish setup later" href="/docs/getting-started/setup-checklist" description="Resume skipped steps from the Command center or your account menu." />
<Card title="Find your way around" href="/docs/getting-started/find-your-way" description="The sidebar, top bar, notifications and your account menu." />
<Card title="Connect a channel" href="/docs/channels/connect-a-channel" description="Add more channels and accounts from Setup." />
</Cards>
