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

# Quick Start

> How to set up a connection with Bracket

## Summary

Bracket lets you connect CRMs and databases for two-way or one-way syncs. In this guide, we'll talk through how to get everything connected in a few quick steps.

<Info>If you'd like to join a private Slack or Discord group with our team for support or questions, just ping us at [eng@usebracket.com](mailto:eng@usebracket.com)</Info>

## 1. Prepare your data sources for the sync

The prerequisites for a successful sync are:

1. Both data sources are set up (i.e., Bracket does not host on your behalf)
2. The secondary data source is empty of data.

<Tip>Note that if Postgres is your secondary source, you do not need to have a table created before setting up your sync - Bracket can generate it for you.</Tip>

## 2. Create an account on our web app

<Card title="Bracket web app" href="https://app.usebracket.com" icon="link" iconType="duotone">Set up your syncs here</Card>

## 3. Enter connection details for each data source

On the web app, you'll need to enter certain connection details to get syncs running. See below for a summary of what information you'll need.

| Data source                                     | What you'll need                          |
| ----------------------------------------------- | ----------------------------------------- |
| [Postgres](/connecting/postgres_connecting)     | Connection string URI                     |
| [Salesforce](/connecting/salesforce_connecting) | A valid Salesforce account                |
| [Hubspot](/connecting/hubspot_connecting)       | A valid Hubspot account                   |
| [Airtable](/connecting/airtable_connecting)     | An existing Airtable base                 |
| [MySQL](/connecting/mysql_connecting)           | Connection string URI                     |
| [DynamoDB](/connecting/mongodb_dynamodb)        | Access key, secret access key, and region |
| [MongoDB](/connecting/mongodb_connecting)       | Connection string URI                     |
| [Google Sheets](/connecting/gsheets_connecting) | An existing Google Sheet                  |

<Example>
  <img class="rounded-md w-full" src="https://mintcdn.com/bracket/1whZePpi8DloDf7s/img/onboarding_choose_primary_source.gif?s=ca3116cd34d7ca9dce6ecfd37f4647b2" width="1060" height="720" data-path="img/onboarding_choose_primary_source.gif" />
</Example>

## 4. Review the fields to be synced and choose sync direction

On this page, you can remove any fields that you do not want synced. While Bracket auto-maps
fields based on field names, you can also adjust the mapping as needed.

<Accordion icon={"lightbulb"} title="Optional: Manually setting mapped fields">
  In the case that you have many fields that you want to modify (delete, add, edit etc), you can
  manually upload a field mapping in the following file format:

  <Snippet file="example_field_mapping.mdx" />
</Accordion>

<Example>
  <img class="rounded-md w-full" src="https://mintcdn.com/bracket/1whZePpi8DloDf7s/img/onboarding_field_mapping.gif?s=d0b179590744dc3f2adde805f28493b7" width="1060" height="720" data-path="img/onboarding_field_mapping.gif" />
</Example>

## 5. Name your sync and choose sync frequency.

<Example>
  <img class="rounded-md w-full" src="https://mintcdn.com/bracket/1whZePpi8DloDf7s/img/onboarding_name_sync.gif?s=95f5ef2d6ea4443f0d2248cdea9eec4a" width="1060" height="720" data-path="img/onboarding_name_sync.gif" />
</Example>

## 6. Initiate sync

When you create your sync, your primary source will automatically seed the secondary source if the secondary source is empty of data.

<Warning>If the secondary data source is already populated, the seed will fail. However, we strongly recommend clearing the secondary source before trying to run another sync job, otherwise you may duplicate data.</Warning>

After that initial seed, to make sure the sync will work as expected, click "Test run," then
refresh the page to see the result of the test.

<Example>
  <img class="rounded-md w-full" src="https://mintcdn.com/bracket/bx6DzcifAPUE0Au7/img/starting_test_run.gif?s=7f366ca77cc219ac438b6559828e89a7" width="1768" height="1080" data-path="img/starting_test_run.gif" />
</Example>

Then, click "Run once" or toggle the sync to `Active` to begin the sync. Refresh the page to
verify that a sync job has been scheduled.

<Example>
  <img class="rounded-md w-full" src="https://mintcdn.com/bracket/bx6DzcifAPUE0Au7/img/starting_sfdc_sync.gif?s=e5d0051513aed1b8a28c02de46eb7b9b" width="1180" height="716" data-path="img/starting_sfdc_sync.gif" />
</Example>
