CRM

Find CRM company accounts

Find saved CRM companies by name, email, or website. Choose the user's intended organization; platform is Endurance HQ's own CRM and requires a platform admin. Omit organizationId only for personal CRM. Returns saved account IDs and source notes for readback.

Method

GET

Path

/v1/crm/accounts

Required scope

crm:read

Request

curl -X GET "https://api.endurancehq.app/v1/crm/accounts" \
  -H "Authorization: Bearer $EHQ_API_KEY"

Query schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "organizationId": {
      "description": "CRM owner: use platform for Endurance HQ's own CRM (platform admins only), or an authorized Clerk organization ID. Omit only for your personal CRM.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "search": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "websiteUrl": {
      "type": "string",
      "maxLength": 500,
      "format": "uri"
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "limit"
  ],
  "additionalProperties": false
}

Response

Success status: 200

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "organizationId": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "websiteUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ]
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "href": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "organizationId",
          "name",
          "kind",
          "status",
          "websiteUrl",
          "email",
          "sourceUrl",
          "notes",
          "href"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "data"
  ],
  "additionalProperties": false
}

Other surfaces

CLI: ehq crm list --organization <org_id> --search <company>

MCP tool: ehq_crm_accounts_list