integrations

Add a user to an organization (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
POST /admin/organization/add-user-to-org
Access token

Adds the user with email to the organization given by orgId or orgName with role invitedUserRole (member by default), first creating the account with name and password (random when omitted) when no user has that email, and recalculates the seats. Sends a password-reset email unless sendResetPasswordEmail is false, and succeeds without changes when the user is already a member; returns 404 for an unknown organization. Super admin only.

application/json

Body Required

  • email string Required
  • name string Required
  • invitedUserRole string

    Values are user, client, employee, billing, full_access, admin, owner, or member. Default value is member.

  • orgId string

    required if orgName not sent

  • orgName string

    required if orgId not sent

  • password string

    If not set a random password is set

  • sendResetPasswordEmail boolean

    Default value is true.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • message string Required
      • isSuccess boolean Required
    • statusCode number Required
    • timestamp string(date-time) Required
POST /admin/organization/add-user-to-org 
curl \
 --request POST 'http://api.example.com/admin/organization/add-user-to-org' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "email": "string",
  "name": "string",
  "invitedUserRole": "member",
  "orgId": "string",
  "orgName": "string",
  "password": "string",
  "sendResetPasswordEmail": true
}'
Request examples 
{
  "email": "string",
  "name": "string",
  "invitedUserRole": "member",
  "orgId": "string",
  "orgName": "string",
  "password": "string",
  "sendResetPasswordEmail": true
}
Response examples (200) 
{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}