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

# Users & Accounts FAQ & Troubleshooting

> Example section for showcasing API endpoints

There are two ways to manage users and accounts with Captain Data:

1. **Platform Access** — Manage workflows via our user-friendly Platform UI.
2. **API Access** — Directly manage your users and accounts through our API.

## **Platform Users**

<Info>
  Designed for **GTM teams** (growth, sales, and marketing) that want to build
  and manage workflows directly through Captain Data's Platform UI.
</Info>

**User Roles & Permissions**:

* **Owner** - Full platform access with permissions to manage users, accounts, billing, and subscriptions. Best for project managers or workspace administrators.

* **User** - Basic platform access but **no rights** to manage billing or subscriptions. Best for team members like marketing or sales staff.

* **External User** - No access to the Captain Data platform. Can only connect accounts via shared links. Best for External SaaS users or Clients.

## **API Customers**

As described in the article [Adding & Managing Users](/v3/users-accounts/add-manage-users), you can use Captain Data's API to manage your SaaS users directly. This approach provides flexibility, scalability, and white-label capabilities.

Reminders for **API Usage Modes**:

<AccordionGroup>
  <Accordion title="1. White Label">
    * Your company's **branding takes center stage**, but Captain Data powers everything behind the scenes.
    * Example: Companies like **Zeliq** use their own Chrome extension and branding while leveraging Captain Data as the backend. Users see **Zeliq's branding** instead of Captain Data.

    <Tip>Ideal for: Companies that want a fully branded, customer-facing experience with complete Captain Data support in the background.</Tip>
  </Accordion>

  <Accordion title="2. White Label — Stealth Mode">
    * **Rent LinkedIn accounts** without using a Chrome extension.
    * Use Captain Data as an API or data provider while we manage the accounts for you.

    <Tip>Ideal for: Companies that want a "behind-the-scenes" integration with zero visibility to end users.</Tip>
  </Accordion>

  <Accordion title="3. Grey Label">
    * A hybrid model where users interact with **Captain Data's Chrome extension**, which remains branded as "Captain Data.
    * Often utilizes the **Shared Account feature**, enabling users to send access links for easy account connection.

    <Tip>Ideal for: Companies that want some level of control but don’t mind limited Captain Data branding visibility.</Tip>
  </Accordion>
</AccordionGroup>

## Accounts Management FAQ

<AccordionGroup>
  <Accordion title="Do I need to pass the li_a cookie to add a Sales Navigator account when using POST - Add or Update Integration Account?">
    No, it is not required to pass the `li_a` cookie in the request body.

    We automatically generate the `li_a` cookie during the **last update** based on the `li_at` value.

    However, if the user has multiple subscriptions (e.g., **Sales Navigator** and **Recruiter**), providing the `li_a` cookie is preferred. It can make the API call faster as it is tied to the session.

    > Related Article: [Adding & Managing Users](/v3/users-accounts/add-manage-users)
  </Accordion>

  <Accordion title="How does Captain Data handle profile visits and limits imposed by LinkedIn?">
    Captain Data respects LinkedIn’s limits and uses **Smart Limits** to avoid exceeding the daily number of visits. Currently, LinkedIn allows 50-80 profile visits per day.

    > Related Article: [Smart Limits - how to avoid getting warned on social accounts](/v3/linkedin/limits)
  </Accordion>

  <Accordion title="What to do if you get invalid cookies from an account?">
    If the cookies are invalid, it’s likely because the user has either logged out and logged back in (generating new cookies), or the cookies have expired.
    If LinkedIn disconnects you, make sure the user logs in again to both LinkedIn and Sales Navigator to generate new cookies.

    While a job is running or when launching a job, the system will return an error message and pause your job.

    **Solutions**:

    1. **Wait for the extension to refresh the cookies automatically** (every 2 hours).
    2. **Manually update the cookies** by performing a POST request to **Add or Update Integration Account**. For this, you will need the new `li_at` and `li_a` cookies (preferably from Sales Navigator).

    > Related Article: [Retry a Run](/v3/runs/errors-retries)
  </Accordion>

  <Accordion title="When does Captain Data refresh LinkedIn Integration Accounts to avoid invalid cookies?">
    Captain Data refreshes cookies for LinkedIn accounts every 2 hours to ensure the session remains active and avoid invalid cookies.

    If you're using your **own Chrome Extension (white label)**, you should build a similar mechanism to maintain session activity.

    > Related Article: [Building Chrome Extensions for LinkedIn & Source Code](/v3/linkedin/chrome-extension)
  </Accordion>

  <Accordion title="What do I need to pass to connect an integration External account with a Shared Link?">
    **For Grey Label Only:** This feature works exclusively with our Chrome Extension, as the Shared Link is provided directly by the Captain Data Extension.

    To create an external shared integration account, pass the `shared_account: true` parameter in the request body using [Add or Update Integration Account](/v3/api-reference/integrations/add-update-account).

    ```bash
      curl --request POST \
        --url https://api.captaindata.co/v3/integrations/{integration_uid}/accounts \
        --header 'Authorization: <api-key>' \
        --header 'Content-Type: application/json' \
        --header 'x-project-id: <api-key>' \
        --data '{
        "account": { ... },
        "shared_account": true
      }'
    ```

    > Related Article: [Adding & Managing Users](/v3/users-accounts/add-manage-users)
  </Accordion>

  <Accordion title="Can I ask Captain Data for rented LinkedIn & Sales Navigator accounts?">
    Yes absolutely! We handle creating "rented" accounts that are completely bundled.
    You just need to contact us or click on **“Add bundled account”** on the LinkedIn integration.

    > Related Article: [When to Sync Identities vs. Use Rented LinkedIn Accounts](/v3/users-accounts/users-vs-rented-accounts)
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="What should I do if the integration doesn’t sync properly?">
    We recommend  you to:

    * Check if the parameters (e.g., country, shared\_account, etc.) are set correctly.
    * When updating an account, only update the fields you want to change.

      <Tip>Implement retries when updating an account and ensure timeouts are appropriately set.</Tip>

      > Related Articles: [Adding & Managing Users](/v3/users-accounts/add-manage-users) as well as Errors & Retries Mechanism
  </Accordion>
</AccordionGroup>