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

# Integrate with 1Password

> Integrate 1Password with Gorelo to sync items across vaults for search, embedding, and related items, using the MSP edition and a Service Account Token.

Integrating 1Password with Gorelo allows you to sync 1Password items across your vaults into Gorelo for use in search, embedding, related items and more.

We recommend the **MSP Edition**\
[**https://1password.com/product/enterprise-password-manager-msp-edition**](https://1password.com/product/enterprise-password-manager-msp-edition)

<Steps>
  <Step title="Navigate to Settings > Integrations" />

  <Step title="Click the ⚙️cog icon to configure 1Password." />

  <Step title="Fill in the required fields:">
    | Field             | Value                                                                                                                                             | Example                                                                                                                                          |
    | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
    | **URL**           | In any 1Password application, right-click an item and choose ‘Copy Private Link’ and paste it here to auto-fill your Custom Domain and Account ID | `https://start.1password.com/open/i?a=ABCD1EFGH2IJKL3MNOP4QRST5U&v=abcd1234efgh5678ijkl9012mn&i=zyxw9876vuts5432rqpo1098ml&h=acme.1password.com` |
    | **Custom Domain** | Your [1password.com](http://1password.com) subdomain and will be auto-filled by your 1Password                                                    | `acme.1password.com`                                                                                                                             |
    | **Account ID**    | Your account ID and will be auto-filled by your 1Password URL                                                                                     | `ABCD1EFGH2IJKL3MNOP4QRST5U`                                                                                                                     |

    **Service Account Token:**

    * Navigate to your 1Password admin console > Developer > Service accounts.
    * Click **New service account** up the top right.
    * Enter `Gorelo` as the name.
    * Select your vaults and give **write permissions.**
    * Create the account and copy the service account token into Gorelo.

    <Frame>
      <img src="https://mintcdn.com/gorelo/LyPoOoPRjQWsuxm2/images/image-165.png?fit=max&auto=format&n=LyPoOoPRjQWsuxm2&q=85&s=44f21baae0a40ac804a12144ac312695" alt="Image" width="858" height="555" data-path="images/image-165.png" />
    </Frame>
  </Step>

  <Step title="Click Connect and the Group.">
    Vault mapping screen will appear.
  </Step>

  <Step title="Map Gorelo Groups to the appropriate 1Password Vaults.">
    <Frame>
      <img src="https://mintcdn.com/gorelo/LyPoOoPRjQWsuxm2/images/image-166.png?fit=max&auto=format&n=LyPoOoPRjQWsuxm2&q=85&s=41a2e2774197675bd6dfdfcb665ec80e" alt="Image 166" width="997" height="373" data-path="images/image-166.png" />
    </Frame>
  </Step>

  <Step title="Click Map when complete." />
</Steps>

## Troubleshooting

<Accordion title="1Password integration displays 'read only' permissions when trying to sync.">
  Your integration is probably missing the write permission (step 3). To change the vaults/permissions, 1Password requires you to **delete the service account and recreate it**. Make sure to add the write permission when adding the Service Account Token.
</Accordion>