> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hotjar

> 4 actions available for Hotjar through StackOne. Use via Actions RPC, Toolset SDK, MCP, or A2A.

<div className="not-prose" style={{ display: 'flex', alignItems: 'center', gap: '12px', marginBottom: '24px' }}>
  <img src="https://stackone-logos.com/api/hotjar/filled/png" alt="Hotjar" className="connector-page-icon" style={{ width: '48px', height: '48px', borderRadius: '10px', padding: '2px' }} />

  <div>
    <div style={{ fontSize: '24px', fontWeight: '600' }}>Hotjar</div>
    <div className="connector-page-subtitle" style={{ fontSize: '14px' }}>4 actions · 1 auth method</div>

    <div style={{ display: 'flex', flexWrap: 'wrap', gap: '6px', marginTop: '8px' }}>
      <span className="connector-page-tag-beta" style={{ display: 'inline-block', padding: '2px 8px', borderRadius: '4px', fontSize: '11px', fontWeight: '500' }}>Beta</span>
      <span className="connector-page-category-tag" style={{ display: 'inline-block', padding: '2px 8px', borderRadius: '4px', fontSize: '11px', fontWeight: '500' }}>Users</span>
    </div>
  </div>
</div>

## Authentication

<Columns cols={2}>
  <Card title="OAuth 2.0">
    OAuth 2.0 Client Credentials flow. Hotjar API access requires a Scale plan (Observe Scale or Ask Scale). API keys auto-e...

    Guides: [Connector Profile](/connectors/hotjar/guides/connector-profile/oauth-2-0), [Link Account](/connectors/hotjar/guides/link-account/oauth-2-0)
  </Card>
</Columns>

<div className="connector-meta-library-section">
  <div className="connector-meta-library-title">Actions</div>

  <div className="connector-actions-controls not-prose" data-connector-actions-controls>
    <div className="connector-actions-controls__row">
      <input type="search" className="connector-actions-search" data-connector-actions-search placeholder="Search actions" aria-label="Search actions" />

      <div className="connector-actions-scopes" data-connector-actions-scopes>
        <button type="button" className="connector-actions-scopes__toggle" data-connector-actions-scopes-toggle aria-expanded="false">
          <span>Scopes<span data-connector-actions-scopes-count /></span>
        </button>

        <div className="connector-actions-scopes__menu">
          <div className="connector-actions-scopes__header">
            <input type="search" className="connector-actions-scopes__search" data-connector-actions-scope-search placeholder="Search scopes..." aria-label="Search scopes" />

            <div className="connector-actions-scopes__actions">
              <button type="button" data-connector-actions-scopes-select-all>Select all</button>
              <span>|</span>
              <button type="button" data-connector-actions-scopes-clear>Clear</button>
            </div>
          </div>

          <label className="connector-actions-scopes__item">
            <input type="checkbox" value="hotjar.responses_read" data-connector-actions-scope-filter />

            <span>hotjar.responses\_read</span>
          </label>

          <label className="connector-actions-scopes__item">
            <input type="checkbox" value="hotjar.user_lookup" data-connector-actions-scope-filter />

            <span>hotjar.user\_lookup</span>
          </label>

          <div className="connector-actions-scopes__empty" hidden>No scopes found</div>
        </div>
      </div>
    </div>
  </div>

  <div className="meta-library-count" data-connector-actions-count>4 actions</div>

  <div className="not-prose meta-library-table-container" data-connector-actions-table>
    <div className="connector-meta-library-grid" style={{ gridTemplateColumns: '200px 1fr 150px' }}>
      <div className="connector-meta-library-row">
        <div className="meta-library-grid-header-cell">Action</div>
        <div className="meta-library-grid-header-cell">Description</div>
        <div className="meta-library-grid-header-cell">Required scopes</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hotjar_list_surveys" data-action-label="List Surveys" data-action-scopes="hotjar.responses_read">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>List Surveys</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="hotjar_list_surveys" aria-label="Copy hotjar_list_surveys"><code className="connector-page-code">hotjar\_list\_surveys</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List all surveys configured on a Hotjar site with cursor-based pagination</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><button type="button" className="connector-page-code-button" data-copy="hotjar.responses_read" aria-label="Copy scope hotjar.responses_read"><code className="connector-page-code">hotjar.responses\_read</code></button></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hotjar_get_survey" data-action-label="Get Survey" data-action-scopes="hotjar.responses_read">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Survey</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="hotjar_get_survey" aria-label="Copy hotjar_get_survey"><code className="connector-page-code">hotjar\_get\_survey</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve full details of a single survey including its question definitions</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><button type="button" className="connector-page-code-button" data-copy="hotjar.responses_read" aria-label="Copy scope hotjar.responses_read"><code className="connector-page-code">hotjar.responses\_read</code></button></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hotjar_list_survey_responses" data-action-label="List Survey Responses" data-action-scopes="hotjar.responses_read">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>List Survey Responses</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="hotjar_list_survey_responses" aria-label="Copy hotjar_list_survey_responses"><code className="connector-page-code">hotjar\_list\_survey\_responses</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List collected responses for a specific survey with cursor-based pagination</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><button type="button" className="connector-page-code-button" data-copy="hotjar.responses_read" aria-label="Copy scope hotjar.responses_read"><code className="connector-page-code">hotjar.responses\_read</code></button></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hotjar_lookup_user" data-action-label="Look Up User Data" data-action-scopes="hotjar.user_lookup">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Look Up User Data</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="hotjar_lookup_user" aria-label="Copy hotjar_lookup_user"><code className="connector-page-code">hotjar\_lookup\_user</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Asynchronously look up (and optionally delete) all Hotjar data associated with a specific end-user across all sites in t...</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><button type="button" className="connector-page-code-button" data-copy="hotjar.user_lookup" aria-label="Copy scope hotjar.user_lookup"><code className="connector-page-code">hotjar.user\_lookup</code></button></div>
        </div>
      </div>
    </div>
  </div>
</div>

## Getting Started

<Steps>
  <Step title="Create or Select a Project">
    Set up a new project or select an existing one. See the [Projects Guide](/guides/managing-projects).
  </Step>

  <Step title="Configure the Connector">
    Enable the connector and set up a connector profile in your project. See [Managing Connectors](/guides/explore-connectors).

    <Columns cols={2}>
      <Card title="Connector Profile" href="/connectors/hotjar/guides/connector-profile/oauth-2-0" icon="https://stackone-logos.com/api/hotjar/filled/png" horizontal>
        Hotjar - OAuth 2.0
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Connect an account using [StackOne Hub](/guides/embedding-stackone-hub) or [Auth Link](/guides/auth-link).

    <Columns cols={2}>
      <Card title="Link Account" href="/connectors/hotjar/guides/link-account/oauth-2-0" icon="https://stackone-logos.com/api/hotjar/filled/png" horizontal>
        Hotjar - OAuth 2.0
      </Card>
    </Columns>
  </Step>

  <Step title="Use Actions">
    Invoke actions using one of the methods below:

    * [MCP](/mcp/quickstart) – Model Context Protocol for AI assistants
    * [A2A](/a2a/quickstart) – Agent-to-Agent protocol
    * [AI Toolset (TypeScript)](/agents/typescript/introduction) – TypeScript SDK for AI agents
    * [AI Toolset (Python)](/agents/python/introduction) – Python SDK for AI agents
    * [Actions RPC](/platform/api-reference/actions/make-an-rpc-call-to-an-action) – Direct API calls
    * [Playground](/guides/playground) – Test actions in the dashboard
  </Step>
</Steps>