integrations

Invite users to an organization

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 /organization/{orgId}/invite
Access token

Invites each email, as member unless a role is given. Existing members are skipped and a pending invitation is sent again; when auto-accept is on, existing users are added directly. Requires a member role or above in the organization and an active plan (403 otherwise). A plain member may only invite clients or members (401 otherwise), and 403 is returned when the plan's seat limit is reached.

Path parameters

  • orgId string Required

    Id of the organization

application/json

Body Required

Invitation request body

  • users array[object] Required
    Hide users attributes Show users attributes object
    • email string Required
    • name string

      Minimum length is 1, maximum length is 200.

    • invitedUserRole string

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

    • sendInstructions boolean

      Default value is false.

Responses

  • 201 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 /organization/{orgId}/invite 
curl \
 --request POST 'http://api.example.com/organization/{orgId}/invite' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "users": [
    {
      "email": "string",
      "name": "string",
      "invitedUserRole": "member",
      "sendInstructions": false
    }
  ]
}'
Request examples 
{
  "users": [
    {
      "email": "string",
      "name": "string",
      "invitedUserRole": "member",
      "sendInstructions": false
    }
  ]
}
Response examples (201) 
{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 201,
  "timestamp": "2026-01-15T10:15:00.000Z"
}