# Manage teams and projects

> Create a team and its projects, find your way around a project, and move a project to production.

A team owns its members, team keys, billing, projects and team audit history.
A project groups Numbers, project tokens, webhooks, templates, campaigns and
integration settings. A project token works only inside its own project, so use
separate projects when you need Numbers, credentials or webhooks kept apart.

## Before you begin

- Sign in to the [Console](https://www.polymorfa.com/console).
- Creating projects through the API needs a team key with `sessions:manage`.
  Project tokens cannot create projects.

## Create a team

New accounts create their first team during onboarding:

1. Choose a language. Onboarding supports English and Brazilian Portuguese,
   and the choice applies to the whole Console. See
   [Choose a language](https://docs.polymorfa.com/teams/language).
2. If you have pending invitations, the Console lists them first. Select
   **Join team** to join one, or **Create my own team instead**.
3. Name the team. Onboarding then shows the team's billing mode, Free, and
   what it includes. It does not ask you to pay.

Onboarding saves your progress as you go. If a step fails to save, stay on it
and retry; reopening an unfinished team resumes where you stopped.

You can create a team only while you belong to no team, until you own a
Pay-As-You-Go team. After that, you can create more. Accepting invitations is
never limited. When the limit applies, the team switcher shows
**Upgrade to create teams**.

## Free and Pay-As-You-Go teams

Every team starts on Free and stays usable for as long as you need: Free
projects do not expire. A Free team has one project and one real Number at no
charge. Upgrade to Pay-As-You-Go for more projects and real Numbers. Every
team can have any number of members.

See [How billing works](https://docs.polymorfa.com/billing) for the full comparison and
[Upgrade to Pay-As-You-Go](https://docs.polymorfa.com/billing/upgrade) for the checklist.

## Rename a team

1. Open **Team settings** > **General**.
2. Edit **Team Name**, or upload a **Team Avatar** (JPG, PNG or GIF, up to
   2 MB).
3. Save.

## Create a project

**Console:**

1. Open **Projects** and select **New**. The same flow opens from the project
   switcher.
2. Enter a project name and choose its icon.
3. On a Free team, choose **Stay on Free** or **Upgrade to Pay-As-You-Go**.
   Then choose the default Number tier.
4. Review the project and select **Create project**.

Choosing **Upgrade to Pay-As-You-Go** opens the
[upgrade checklist](https://docs.polymorfa.com/billing/upgrade) after the project is created; it does not
upgrade the team on its own. **Stay on Free** opens the project so you can
connect test numbers and build your integration.

**API:**

```bash
curl -X POST "https://api.polymorfa.com/platform/projects" \
  -H "Authorization: Bearer $POLYMORFA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Support desk", "defaultTier": "standard" }'
```

`name` is required. See [Create a project](https://docs.polymorfa.com/api/projects/create-project)
and [List projects](https://docs.polymorfa.com/api/projects/list-projects).

A Free team can have one project. Creating another returns `409` with the code
`payg_required`, and in the Console **New** shows an upgrade prompt.

## Find your way around a project

The team overview shows Usage and Billing, your projects, and Analytics and
logs. Search projects by name and view them as **Gallery** or **Table**. Each
project card shows its connected Numbers, spending-limit progress, message
totals and last activity. **Health** on a card counts connected Numbers, such
as **1 / 2 connected**; open **Numbers** for each Number's state.

A project has these tabs, each with its own URL:

| Tab | What it holds |
| --- | --- |
| **Get started** | The project checklist. A project opens here by default. |
| **Overview** | Analytics for the project. |
| **Activity** | Recent logs, campaign results, template approvals, and Flow and screen counts. |
| **Settings** | Name, icon and default Number tier, plus links to API keys, webhooks, Drains and QuickLink settings. |
| **Funding** | The project budget. Shown to owners and admins on Pay-As-You-Go. |

The summary row above the tabs shows the **Project ID** with a copy button. Integrations use this
ID, not the URL slug.

## Change project settings

Owners and admins can change a project's name, icon and default Number tier in
**Settings**. The project's ID and URL stay the same.

The default Number tier applies to Numbers without their own tier. Changing it
changes those Numbers' effective tier; Numbers with their own tier keep it.
See [Number tiers](https://docs.polymorfa.com/billing/number-tiers).

To delete a project, open its **Settings** > **General** and select
**Contact support** under **Delete project**. Support deletes the project on
request, with its Numbers, API keys, webhooks and data.

## Move a project to production

Production enrollment needs a Pay-As-You-Go team. A Free team's request returns
`409` with the code `payg_required`.

**Console:**

Select **Upgrade to Pay-As-You-Go** on the project overview, or choose it when
you create a project. When the upgrade is confirmed, the
[upgrade checklist](https://docs.polymorfa.com/billing/upgrade) requests production enrollment for the
project using the business details you entered.

**API:**

Call [Request production enrollment](https://docs.polymorfa.com/api/projects/request-production-enrollment)
with the project's business details. The response has an `operationId`; read
`GET /platform/operations/{operationId}` until its status is `succeeded`,
`failed`, `cancelled` or `action_required`.

- On `action_required`, resolve the reported requirement, then call
  [Approve production enrollment](https://docs.polymorfa.com/api/projects/approve-production-enrollment).
- To stop an enrollment in progress, call
  [Cancel production enrollment](https://docs.polymorfa.com/api/projects/cancel-production-enrollment).
  Polymorfa removes what it provisioned before the operation reaches
  `cancelled`.

The project stays in development until enrollment succeeds.

## Get help

Use the chat in the lower-right corner of any Console page to contact support.
It accepts attachments and keeps the conversation across pages. The support
code in the sidebar, above **Documentation**, copies the active team's code, or
your personal code under **Account**. You can also email
[support@polymorfa.com](mailto:support@polymorfa.com).

Your personal account settings are in
[Secure your account](https://docs.polymorfa.com/teams/account-security), notification settings in
[Choose notifications](https://docs.polymorfa.com/teams/notifications), and team deletion in
[Delete a team](https://docs.polymorfa.com/teams/delete-a-team).

## See also

- [Invite members and set roles](https://docs.polymorfa.com/teams/members)
- [API keys](https://docs.polymorfa.com/development/api-keys)
- [Connect a Number in the Console](https://docs.polymorfa.com/numbers/connect-in-console)
- [Team API reference](https://docs.polymorfa.com/api/team/get-team)
