---
title: blossom profile:create
url: "/docs/reference/cli/profile/create/"
canonical_url: https://docs.blossom88.com/docs/reference/cli/profile/create/
markdown_url: https://docs.blossom88.com/docs/reference/cli/profile/create.md
summary: Create a profile for one Account
categories:
- cli
- reference
---

# blossom profile:create

Create a profile for one Account

## Usage

    blossom profile:create [--data DATA] [--name NAME] [--login] [--no-browser]

## Flags

| Flag | Description |
| --- | --- |
| `--data, -d` | YAML or JSON profile data, a path to a data file, or an HTTP(S) URL |
| `--name` | Optional profile name; defaults to your username |
| `--login` | Approve in your browser and save login credentials automatically |
| `--no-browser` | Print the login URL instead of opening a browser |

Examples:

    blossom profile:create --login
    blossom profile:create --name production --login
    blossom profile:create --login --no-browser
    blossom profile:create --data profile.yml --login

New profiles default to https://app.blossom88.com, regardless of the selected
profile. Override with `BLOSSOM_API_URL` or `profile.api_url` in a data file;
the environment variable takes precedence. The chosen endpoint is saved.

With `--login`, choose your Account on the approval page. Blossom creates and
saves the login credentials automatically; you do not need to copy a token.
The URL and code are always printed. A browser opens when available locally;
SSH and headless sessions use the printed URL. `--no-browser` always skips opening.

Omit `--name` to use your login username. If taken, Blossom chooses `tung-2`,
`tung-3`, and so on. Without a username, it uses your email prefix or display
name, falling back to `user`.
An explicit name must be unused. Existing profiles are never overwritten.

`blossom login --new-profile NAME` is a shortcut for named browser setup.

Creating a profile does not switch context. Completion prints the exact command
to select it, for example:

    blossom profile:use --name tung-2
    blossom profile:set
    blossom profile:current

For an existing API token, omit `--login` and use a data file:

```yaml
profile:
  name: production
  api_url: https://app.blossom88.com
  token: ${BLOSSOM_TOKEN}
  # Optional: verify the token belongs to this Account.
  # account: account-100
```

    blossom profile:create --data profile.yml

Without `token`, setup uses browser login. CI requires a token. Existing names
cannot be overwritten; select the profile and run `blossom login` to renew it.

Settings are saved in `~/.config/blossom/profiles/NAME.yml`; login credentials
are stored separately under `~/.config/blossom/credentials/NAME.yml`.

Use `blossom profile:set` to pick a Location after selecting the profile.
It saves the choice without another login or editing files. Create another named
profile with its own login if you prefer separate contexts for different Locations.

Optional `profile.location_id` in a data file must belong to the Account. Without
it, regional commands use the Account default. `--location` overrides it for one command.