How to use Multilogin API as a team member with Postman
Article scenario:
- Workspace User: [email protected] (team member)
- Workspace Owner: [email protected] (subscription payer)
Step 1: sign in to team member account via API
- Open Postman → in “Collections”, expand “Multilogin X API”
- In “Profile Access Management” → open POST User Sign In endpoint
- Go to the “Body” tab and ensure it is set to “raw”
- In the request body, fill in the team member’s e-mail and password
- The password needs to be converted to a MD5 Hash
- Send the request → if correct, it will return a Status: 200 OK notice
- Copy the
“token”
string, leaving out quotation marks. The“refresh_token”
will also be used later
New regular tokens are valid for 30 minutes.
Step 2: get team owner's workspace ID
Before a team member creates automation tokens or makes API calls in a workspace, they must first get the Owner’s Workspace ID (not their own)!
To get the Owner’s workspace ID:
- In “Collections” → go to “Profile Access Management”
- Click on the GET User Workspaces endpoint
- In the “Authorization” tab, set “Auth Type” to “Bearer Token”
- Add the
“token”
from the previous step (remove any quoting marks)
The response body shows two workspace IDs for [email protected]
:
-
Manager (TM) of Valner’s workspace →
“81784234-8be8-47eb-9db2-238ada5df21f”
- This is the desired workspace ID, where the team member will perform automation. To switch to this workspace, refresh the token.
-
Owner of his workspace →
“91f042e6-da57-4e1f-adee-5eed6bb47d60”
- This is the team member’s own workspace, that has no subscription in it.
Step 3: request a refreshed token to switch workspace
Using the “refresh_token”
, “workspace_id”
, and “token"
objects obtained earlier, the team member can request a refreshed token:
- In “Collections” → go to “Profile Access Management” folder
- Go to POST User Refresh token endpoint
- In the “Authorization” tab, set “Auth Type” to “Bearer Token”
- Paste your
“token”
in the field - Go to “Body” tab → select “raw”
- Make sure that the request body includes:
- The team member’s email
- The
“refresh_token”
from POST User Sign In - The team owner’s
“workspace_id”
from GET User Workspaces
- Send the request
This token is specific to valner.wasilewski
workspace. The refresh_token
object links the member account to the workspace.
Step 4: generate automation token for the team member
Regular tokens expire fast. Generate one with customized duration using the GET Workspace Automation Token endpoint. Custom expiration values: 1h
, 3h
, 5h
, 16h
, 24h
, 48h
, 1w
, 2w
, 3w
, 1mo
, no_exp
.
To generate an automation token from the Owner’s workspace:
- In “Collections” → go to “Profile Access Management” folder
- Open GET Workspace Automation Token
- In the “Authorization” tab, set “Auth Type” to “Bearer Token”
- Use
“token”
obtained from POST User Refresh token - In “Params” → choose the desired custom expiration period
- Send the request
- Get the automation token between quoting marks