integrations

Create a case for a partner

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 /integration/goodfact/create

Partner route: called with the partner API key, not a user token. Finds the lawyer by lawyerEmail or, when there is no such user, creates the user and an organization (named from organizationName or the email domain) with a subscription. Then creates the case and attaches the partner integration with goodfactEndpoint and caseAPIKey, and returns that integration (type, attach date, remote case id and name).

application/json

Body Required

  • lawyerEmail string Required

    Lawyer Email

  • organizationName string Required

    Organization Name

  • goodfactCaseName string Required

    Goodfact Case Name

  • goodfactEndpoint string Required

    Integration Endpoint

  • caseAPIKey string Required

    Goodfact Case Integration API Key

Responses

  • 201 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • createdAt string(date-time) Required
      • updatedAt string(date-time) Required
      • id string Required
      • integrationType string Required

        Values are goodfact, clio, or smokeball.

      • attachedAt string(date-time) Required
      • remoteCaseId string Required
      • remoteCaseName string Required
    • statusCode number Required
    • timestamp string(date-time) Required
POST /integration/goodfact/create 
curl \
 --request POST 'http://api.example.com/integration/goodfact/create' \
 --header "Content-Type: application/json" \
 --data '{
  "lawyerEmail": "string",
  "organizationName": "string",
  "goodfactCaseName": "string",
  "goodfactEndpoint": "string",
  "caseAPIKey": "string"
}'
Request examples 
{
  "lawyerEmail": "string",
  "organizationName": "string",
  "goodfactCaseName": "string",
  "goodfactEndpoint": "string",
  "caseAPIKey": "string"
}
Response examples (201) 
{
  "data": {
    "createdAt": "2026-01-15T14:30:00.000Z",
    "updatedAt": "2026-01-15T14:30:00.000Z",
    "id": "507f1f77bcf86cd799439011",
    "integrationType": "clio",
    "attachedAt": "2026-01-15T14:30:00.000Z",
    "remoteCaseId": "1234567890",
    "remoteCaseName": "Doe v. Example Corp"
  },
  "statusCode": 201,
  "timestamp": "2026-01-15T10:15:00.000Z"
}