> ## 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.

# Connect Capsule CRM with API Key – StackOne Hub

> Link a Capsule CRM account in the StackOne Hub using API Key. End-user guide to authorize the integration and start using Capsule CRM actions.

> [!WARNING]
>
> Personal access tokens should only be used for one-off integrations or development purposes. If you are a developer sharing your application with other people, use the OAuth 2 flow instead.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Generating a Personal Access Token

Capsule CRM calls its API key a Personal Access Token. You generate it from your own Capsule user account, and it inherits that user's access to the account's data.

**1. Sign in to Capsule CRM**

Sign in to your [Capsule CRM account](https://capsulecrm.com/login).

<ul>
  <li>Capsule signs you in per account, so the page asks for your site address first — type it into **Enter your Capsule site address**, then click **Go to Login**.</li>
  <li>Format: `{site-address}.capsulecrm.com`</li>
  <li>Example: if you sign in at `https://acme.capsulecrm.com`, your site address is `acme`</li>
  <li>If you do not know your site address, click **Forgotten your site address?**.</li>
  <li>If you do not have a Capsule account yet, click **Sign up here** to create one.</li>
</ul>

![The Capsule log in page with the site address field and the Go to Login button highlighted](https://mintcdn.com/stackone-60/HeDSLnE7GC4puCp5/connectors/capsulecrm/images/api-key-config-sign-in.png?fit=max\&auto=format\&n=HeDSLnE7GC4puCp5\&q=85\&s=a8c7ada14b054346a177d533eee8cf9d)

**2. Open My Preferences**

Click your profile icon in the top right corner to open the account menu.

<ul>
  <li>Select **My Preferences**.</li>
</ul>

![The Capsule account menu open with My Preferences highlighted](https://mintcdn.com/stackone-60/HeDSLnE7GC4puCp5/connectors/capsulecrm/images/api-key-config-my-preferences.png?fit=max\&auto=format\&n=HeDSLnE7GC4puCp5\&q=85\&s=e98051925a7ebd252841a25e6032b857)

**3. Open API Authentication**

On the **My Preferences** page, click **API Authentication**.

![The My Preferences page with the API Authentication card highlighted](https://mintcdn.com/stackone-60/CzppnbeDMBj74-II/connectors/capsulecrm/images/api-key-config-api-authentication.png?fit=max\&auto=format\&n=CzppnbeDMBj74-II\&q=85\&s=368924b426f18157fc5b1c1d4eb12b8e)

**4. Generate a new token**

Click **Generate New API Token** to open the **Generate Token** dialog.

![The API Authentication page with the Generate New API Token button highlighted](https://mintcdn.com/stackone-60/HeDSLnE7GC4puCp5/connectors/capsulecrm/images/api-key-config-generate-new-api-token.png?fit=max\&auto=format\&n=HeDSLnE7GC4puCp5\&q=85\&s=131b849486f43387f42fddb983952241)

**5. Enter a token description**

In the **Generate Token** dialog, type a name into **Description** that identifies this integration, such as `StackOne Integration`.

![The Generate Token dialog with the Description field and the Scope of this token checkboxes highlighted](https://mintcdn.com/stackone-60/HeDSLnE7GC4puCp5/connectors/capsulecrm/images/api-key-config-generate-token-dialog.png?fit=max\&auto=format\&n=HeDSLnE7GC4puCp5\&q=85\&s=a99ec040a7457e89fda9375f5de20999)

**6. Select the scope of this token**

Enables actions: Add Party To Opportunity, Add Party To Project, Archive Board, Archive Pipeline, Create Board, Create Entry, Create Milestone, Create Opportunity, Create Opportunity Custom Field, Create Opportunity Tag, Create Party, Create Party Custom Field, Create Party Tag, Create Pipeline, Create Project, Create Project Custom Field, Create Project Tag, Create Stage, Create Task, Create Task Category, Create Track, Create Track Definition, Delete Entry, Delete Milestone, Delete Opportunity, Delete Opportunity Custom Field, Delete Opportunity Tag, Delete Party, Delete Party Custom Field, Delete Party Tag, Delete Project, Delete Project Custom Field, Delete Project Tag, Delete Stage, Delete Task, Delete Task Category, Delete Track Definition, Duplicate Pipeline, Filter Opportunities, Filter Parties, Filter Projects, Get Attachment, Get Board, Get Current User, Get Entry, Get Milestone, Get Multiple Opportunities, Get Multiple Parties, Get Multiple Pipelines, Get Multiple Projects, Get Opportunity, Get Opportunity Custom Field, Get Opportunity Tag, Get Party, Get Party Custom Field, Get Party Tag, Get Pipeline, Get Project, Get Project Custom Field, Get Project Tag, Get Site, Get Stage, Get Task, Get Task Category, Get Team, Get Track Definition, Get Unified Credentials, Get Unified Group, Get Unified Organization, Get Unified User, Get User, List Activity Types, List Board Stages, List Boards, List Deleted Opportunities, List Deleted Parties, List Deleted Projects, List Entries, List Lost Reasons, List Milestones, List Opportunities, List Opportunity Custom Fields, List Opportunity Entries, List Opportunity Parties, List Opportunity Projects, List Opportunity Tags, List Parties, List Party Custom Fields, List Party Employees, List Party Entries, List Party Opportunities, List Party Projects, List Party Tags, List Pipeline Milestones, List Pipelines, List Project Custom Fields, List Project Entries, List Project Parties, List Project Tags, List Projects, List Stages, List Task Categories, List Tasks, List Teams, List Track Definitions, List Tracks, List Unified Groups, List Unified Organizations, List Unified Users, List Users, Remove Party From Opportunity, Remove Party From Project, Restore Board, Restore Pipeline, Search Opportunities, Search Parties, Search Projects, Update Board, Update Entry, Update Milestone, Update Opportunity, Update Opportunity Custom Field, Update Opportunity Tag, Update Party, Update Party Custom Field, Update Party Tag, Update Pipeline, Update Project, Update Project Custom Field, Update Project Tag, Update Stage, Update Task, Update Task Category, Update Track Definition, Update User, Upload Attachment

Under **Scope of this token**, select the permissions this integration needs. **Read information from your Capsule account** is always enabled and cannot be turned off. Select **Create, update and delete information from your Capsule account** to write data, and **Update user preferences** only if you need to change a user's own settings, such as locale, currency, or time zone.

<ul>
  <li>
    read
  </li>

  <li>
    write
  </li>

  <li>
    user\_preference
  </li>
</ul>

**7. Generate the token**

Click **Generate Token**.

![The completed Generate Token dialog with the Generate Token button highlighted](https://mintcdn.com/stackone-60/HeDSLnE7GC4puCp5/connectors/capsulecrm/images/api-key-config-generate-token-confirm.png?fit=max\&auto=format\&n=HeDSLnE7GC4puCp5\&q=85\&s=68f286f1c40c3702c98b131643423597)

**8. Copy the personal access token**

Click **Copy** next to the new token, then paste it into the **Personal Access Token** field in StackOne Hub.

<ul>
  <li>Format: a 64-character string of letters, digits and `/`</li>
  <li>The token is only displayed once and cannot be retrieved later — store it securely for use later.</li>
  <li>If you lose it, click **Regenerate** on the token to issue a new value, or **Revoke** to remove it.</li>
</ul>

![The API Authentication page showing the new token with its value hidden and the Copy button highlighted](https://mintcdn.com/stackone-60/HeDSLnE7GC4puCp5/connectors/capsulecrm/images/api-key-config-copy-token.png?fit=max\&auto=format\&n=HeDSLnE7GC4puCp5\&q=85\&s=245695be3af08b19a9ae130a172b44b9)

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Next Steps

> [card] [Webhooks setup](https://docs.stackone.com/connectors/capsulecrm/guides/webhook-setup.md)
>
> Configure receiving Events for Capsule CRM into StackOne.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.