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

# Pinpoint

> Follow these steps to connect Pinpoint with StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your Pinpoint account.
</Warning>

If you've been directed to StackOne to integrate with Pinpoint, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Getting your Subdomain

<Steps>
  <Step title="Find the Subdomain">
    In the URL bar of your browser, you can find the subdomain by selecting the text in front of `.pinpointhq.com`.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Subdomain Example" src="https://mintcdn.com/stackone-hub/BgOrelPgZGaVd2dz/images/pinpoint/image1.png?fit=max&auto=format&n=BgOrelPgZGaVd2dz&q=85&s=65e2f29e34edc355e9e43954e8d653b0" width="2879" height="1699" data-path="images/pinpoint/image1.png" />
    </Frame>
  </Step>
</Steps>

In this example, the value would be: stackone

## Generating API Key

<Steps>
  <Step title="Navigate to Integrations">
    In the left Sidebar, scroll down to the Settings category and select Integrations.
  </Step>

  <Step title="Select the Apps Tab">
    Select the Apps tab and ensure that the Pinpoint API app is Added.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Integrations" src="https://mintcdn.com/stackone-hub/BgOrelPgZGaVd2dz/images/pinpoint/image2.png?fit=max&auto=format&n=BgOrelPgZGaVd2dz&q=85&s=8b7caf8e0c63c3cf5396e50a7868a810" width="2194" height="1628" data-path="images/pinpoint/image2.png" />
    </Frame>
  </Step>

  <Step title="Select MyApps Tab">
    Select the MyApps tab and select the Pinpoint API app.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="MyApps" src="https://mintcdn.com/stackone-hub/BgOrelPgZGaVd2dz/images/pinpoint/image3.png?fit=max&auto=format&n=BgOrelPgZGaVd2dz&q=85&s=58f5029093c993db7230654c603adadc" width="1599" height="640" data-path="images/pinpoint/image3.png" />
    </Frame>
  </Step>

  <Step title="Enable the API">
    Ensure that the slider to the right-hand side of the upper panel is set to Enabled.
  </Step>

  <Step title="Create a New API Key">
    Select the Create New button to create a new API Key.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create API Key" src="https://mintcdn.com/stackone-hub/BgOrelPgZGaVd2dz/images/pinpoint/image4.png?fit=max&auto=format&n=BgOrelPgZGaVd2dz&q=85&s=96af184c2fc9cadb98b2ed7197b5c185" width="1131" height="304" data-path="images/pinpoint/image4.png" />
    </Frame>
  </Step>

  <Step title="Name the API Key">
    Enter a Name for the API Key, for example: `StackOne`.
  </Step>

  <Step title="Assign Permissions">
    Assign Read permissions based on the Integration requirements:

    * Application
    * Department
    * Interview
    * Job
    * Location
    * Scorecard
    * Custom fields
    * User
  </Step>

  <Step title="Create API Key">
    Select Create API Key.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generated API Key" src="https://mintcdn.com/stackone-hub/BgOrelPgZGaVd2dz/images/pinpoint/image5.png?fit=max&auto=format&n=BgOrelPgZGaVd2dz&q=85&s=0281ab49e80729491486089b86d2c608" width="1227" height="1266" data-path="images/pinpoint/image5.png" />
    </Frame>
  </Step>

  <Step title="Copy the API Key">
    Your API Key will be generated and displayed to you. Copy the API Key to a safe place.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy API Key" src="https://mintcdn.com/stackone-hub/BgOrelPgZGaVd2dz/images/pinpoint/image6.png?fit=max&auto=format&n=BgOrelPgZGaVd2dz&q=85&s=8f32fa22855efa691f53b2b41198980d" width="1128" height="197" data-path="images/pinpoint/image6.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter the Details">
    Upon reaching the Link Account page, enter the gathered details and proceed by clicking the `Connect` button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub/BgOrelPgZGaVd2dz/images/pinpoint/image7.png?fit=max&auto=format&n=BgOrelPgZGaVd2dz&q=85&s=6f18100f7e59f6f433f4b7beee4839c2" width="481" height="697" data-path="images/pinpoint/image7.png" />
    </Frame>
  </Step>
</Steps>

## Useful Links

<Card title="API Reference" icon="link" href="https://developers.pinpointhq.com/docs/introduction">
  [https://developers.pinpointhq.com/docs/introduction](https://developers.pinpointhq.com/docs/introduction)
</Card>