MCP

user/post

Tool: create

Create a new user account under the authenticated organization.

Returns the created User object on 201. email and accountType are both required for a valid body.

email and accountType are both required. Omitting either is rejected before dispatch with 400 MCP_VALIDATION_FAILED naming the missing field — see describe("user/post"). A malformed (but present) email reaches upstream and returns a proper 422.

Body

field type req constraints description
email string ≤128 chars User email address.
firstName string ≤512 chars First name.
lastName string ≤512 chars Last name.
accountType string one of: SingleUnibox, SingleReports, SingleSenders, User, Editor, Admin, SuperAdmin Permission level. See schemas/user for role descriptions.

Response

201 — Created User object: see schemas/user. Deltas: none.

Errors: 400, 401, 406, 409, 415, 422, 429, 500 — shared schema: schemas/errors. 400 = a required field (email or accountType) is missing; 422 = malformed email or an invalid accountType value.

Invoke

Call create with name: "user/post".