Skip to content
Shortcut: /, ⌘K or Ctrl+K

Manage teams and projects

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

View as Markdown

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.
  • 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.
  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 for the full comparison and Upgrade to Pay-As-You-Go 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 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

Shell
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 and 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:

TabWhat it holds
Get startedThe project checklist. A project opens here by default.
OverviewAnalytics for the project.
ActivityRecent logs, campaign results, template approvals, and Flow and screen counts.
SettingsName, icon and default Number tier, plus links to API keys, webhooks, Drains and QuickLink settings.
FundingThe 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.

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 requests production enrollment for the project using the business details you entered.

API

Call Request production enrollment with the project's business details. The response has an operationId; read API Get account operation until its status is succeeded, failed, cancelled or action_required.

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.

Your personal account settings are in Secure your account, notification settings in Choose notifications, and team deletion in Delete a team.

See also#