Skip to main content
POST
/
v2
/
team.user.create
CreateUser
curl --request POST \
  --url https://api.manus.im/v2/team.user.create \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "email": "new.user@example.com"
}
'
{
  "ok": true,
  "request_id": "<string>",
  "user": {
    "email": "<string>",
    "user_name": "<string>",
    "team_user_id": "<string>",
    "delegated_to": "<string>",
    "delegated_profiles": [
      {
        "team_user_id": "<string>",
        "display_name": "<string>",
        "delegated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "original_email": "<string>"
  }
}
Questions or issues? Contact us at api-support@manus.ai.
Auto-provisioning: If the email does not yet have a Manus account, a personal account is created automatically (deactivated outside the team). The team membership is then attached to that account.Role: Required. Accepts TEAM_MEMBER_ROLE_SUPER_ADMIN, TEAM_MEMBER_ROLE_ADMIN, TEAM_MEMBER_ROLE_MEMBER, or TEAM_MEMBER_ROLE_GUEST. TEAM_MEMBER_ROLE_OWNER and TEAM_MEMBER_ROLE_UNSPECIFIED return invalid_argument — transfer ownership in the UI instead. Guests do not consume a paid seat.Display name: Optional. If first_name and/or last_name are provided they are joined with a space; otherwise user_name is used as-is.Idempotency: The endpoint is not idempotent — calling it twice with the same email returns already_exists on the second call. Read the existing record with team.user.detail first if you may be retrying.Protocols: Also callable via Connect RPC. See Protocols.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
email
string<email>
required

Email of the user to add. Must be a valid RFC 5321 address.

Maximum string length: 254
Example:

"new.user@example.com"

​
role
enum<string>
required

Initial team role. Accepts TEAM_MEMBER_ROLE_SUPER_ADMIN, TEAM_MEMBER_ROLE_ADMIN, TEAM_MEMBER_ROLE_MEMBER, or TEAM_MEMBER_ROLE_GUEST. TEAM_MEMBER_ROLE_OWNER is rejected.

Available options:
TEAM_MEMBER_ROLE_OWNER,
TEAM_MEMBER_ROLE_ADMIN,
TEAM_MEMBER_ROLE_MEMBER,
TEAM_MEMBER_ROLE_SUPER_ADMIN,
TEAM_MEMBER_ROLE_GUEST
​
user_name
string

Display name. Optional; if omitted, the name is composed from first_name + last_name.

Maximum string length: 255
Example:

"New User"

​
first_name
string

First name. Optional.

Maximum string length: 255
Example:

"New"

​
last_name
string

Last name. Optional.

Maximum string length: 255
Example:

"User"

Response

Team member created successfully.

​
ok
boolean
Example:

true

​
request_id
string
​
user
object

A team member.