Skip to main content
A login profile holds everything a workflow needs to sign in and act as one identity. If the environment is the machine a workflow runs on, a profile is an account on that machine. On the API, name a profile with profileId and a profile group with profileGroupId. Older fields and endpoints call a profile group an agent profile pool. A profile carries:
  • attached secrets (usernames and passwords with optional TOTP seeds, API keys, cards, custom secrets)
  • an email inbox
  • starting cookies
A profile is reusable. Many workflows can share one profile, and one workflow can run with a different profile on every execution. Proxy, captcha solving, stealth, cache persistence and extensions live on the environment the workflow runs on, not on the profile. A workflow with no custom environment runs on a base environment, which accepts any profile.

Sticky IP

To give each login its own address, set Addresses to One per login (sticky) on the environment. That needs no profile setting. A login keeps one saved sign-in for environments that give it its own address, and one for the rest. Clear profile state in the profile’s menu clears both, so on Anchor a login with a sticky IP also gets a new one on its next run.
The Sticky IP switch on a profile is deprecated, and will be removed. A new profile cannot turn it on. Set Addresses to One per login on the environment instead.
A profile that already has the switch on keeps one address when the environment uses the managed proxy, until the switch is removed. Any other network sets the address itself. You can turn it off in the profile’s Signing section, which clears the profile’s saved browser state. Through the API, the stickyIP field on a profile is deprecated too. Set settings.addresses: one_per_login on the custom environment instead.

In the platform

Open Logins in the sidebar. It has four tabs. Click Create a login profile to add one. The form walks through Details, Secrets and Email inbox. Click Ask someone for a login to send a request instead. Click a profile to open its drawer. It has four sections: Click Edit in the drawer header to turn every section into its form, then save once. Starting cookies apply to runs on a browser environment without settings of its own, and to every run on a Linux or Windows environment. A browser environment with settings supplies the cookies, even when its list is empty.

Choosing a profile for a run

An execution uses at most one profile. The workflow’s environment decides which profiles may run. The trigger picks one of them. The list belongs to the environment. Every workflow on the same environment shares it. The run form lists only the allowed rows. See Profile rows and How a run is routed. On the API, pass the profile ID (profileId):
Pass a profile group (profileGroupId) instead to let Asteroid choose a profile from a profile group.
profileId and profileGroupId are mutually exclusive. Pass one or the other, never both. The older agentProfileId and agentProfilePoolId still work but are deprecated.
See Call a workflow from your code for the full execute call.

Profile configuration

Every profile gets an inbox at {prefix}@agentmail.asteroid.ai. The default prefix is the profile’s UUID. Set a prefix to get a readable address. Set it as Inbox address when you create or edit the profile. See Email inbox.
Create and manage profiles on the platform, through the API, or through the SDKs. See the API reference.
Deleting a profile affects every workflow that references it. Check that no live automation depends on it first.

Credentials and 2FA

A profile does not store secret values itself. It attaches secrets from the organization’s Secrets tab. The profile then exposes ##ITEM_KEY.FIELD## placeholders. A profile cannot attach two secrets that share a key. On the API, attach secrets (vaultItemIds) on create or update. On MCP, create them with secrets_create and attach them with profile_update. Profile credentials* fields are deprecated. The same secret can attach to many profiles. See Secrets & 2FA for secret kinds, placeholders, and TOTP seeds.

Profile groups

A profile group holds interchangeable logins for one portal, with the same permissions. You point a run at the group, and Asteroid picks a profile from it. Profile groups solve four problems:
  • Credential conflicts: stop two executions using one account at the same time.
  • Rate limits: spread requests across several accounts.
  • Availability: fall back to another profile when one is busy.
  • Manual selection: remove the choice from every execute call.
Create a group on the Profile groups tab with New profile group. The form walks through Details and Members. The group’s drawer has Members and Settings sections.

Selection strategies

A profile group uses one of two strategies. The drawer shows it as Picks. Least recently used rotates fairly. With profiles A, B and C, an execution after B picks whichever of A or C idled longest. Most recently used concentrates work on fewer profiles. It keeps browser state and authenticated sessions warm.

Concurrent use

allowConcurrentUse decides whether a busy profile can be picked again. The drawer shows it as Shared use.
With allowConcurrentUse: false, a request fails immediately with a 429 when every profile in the group is busy. The error says no profile is available. Add more profiles, allow concurrent use, or send "onCapacityLimit": "queue" on the execute call. The execution is then accepted as queued and starts when a profile frees. See Queue when capacity is full.

Group constraints

An execute call takes profileId or profileGroupId, never both.
  • Every profile in a group belongs to the same organization.
  • A group name is unique within an organization.
  • A profile from another organization cannot join the group.
  • A group needs at least one profile before an execution can use it.
  • Remove the last profile and no new execution can use the group.
Match the group size to your parallelism. Five simultaneous runs need at least five profiles. Add one or two spare profiles for peak load.
A profile group works with every profile feature: attached secrets, TOTP seeds, email inbox, and browser state. The selected profile’s configuration applies exactly as if you had named it yourself.

Call a workflow

Pass a profile or a profile group on the execute call

Secrets & 2FA

How Asteroid stores and uses secrets

Email inbox

The email inbox each profile owns

Environments

Where the workflow runs, and its browser settings

Security

How Asteroid protects stored credentials