# Set up an integration

{% hint style="info" %}
**Recap**\
You have [created a Snyk account](https://docs.snyk.io/~/changes/m2hJeDrttXy2N83AnRjM/getting-started/quickstart/create-a-snyk-account). You now need to tell Snyk where to scan.
{% endhint %}

You must give Snyk access to your environment, to allow Snyk to scan that environment. The type of integration you need depends on what systems you use, and what you want to scan. See [Integrate with Snyk](https://docs.snyk.io/~/changes/m2hJeDrttXy2N83AnRjM/integrations) for a full list of integrations available.

You can set up this integration:

* [Following a guided process](#guided-process-after-signup), immediately after creating a Snyk account.
* [Manually](#manual-process-any-time), at any point.

## Guided process (after signup)

Immediately after you [Create a Snyk account](https://docs.snyk.io/~/changes/m2hJeDrttXy2N83AnRjM/getting-started/quickstart/create-a-snyk-account), you will see some optional getting started walkthrough prompts. You can choose to provide some information to help Snyk guide your experience, and then follow the prompts to integrate your code repository for a seamless experience.

For example:

<figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2Fgit-blob-fb905ad943698679b96f5385be91b757ab69fdda%2Fimage%20(496).png?alt=media" alt=""><figcaption><p>Choose integration method</p></figcaption></figure>

If you select **GitHub**, then fill in the details as prompted.

<figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2Fgit-blob-8882914a20059f8f5e924fd7db96d057b645b861%2Fimage%20(3)%20(1).png?alt=media" alt=""><figcaption><p>Set access permissions</p></figcaption></figure>

<figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2FuTJImiwY1CPQVnig0pfo%2Fimage.png?alt=media&#x26;token=6b837f34-ef68-4eaa-a8fa-cdee00564486" alt=""><figcaption><p>Configure automation settings &#x26; authenticate</p></figcaption></figure>

Finally, you can [Import a Project](https://docs.snyk.io/~/changes/m2hJeDrttXy2N83AnRjM/getting-started/quickstart/import-a-project) to scan:

<figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2Fgit-blob-e9eff61e5e6624c7f36e4825898a1185f79a5063%2Fimage%20(248).png?alt=media" alt=""><figcaption><p>Add your first project</p></figcaption></figure>

## Manual process (any time)

You can add an integration to Snyk manually at any point (See [Integrate with Snyk](https://docs.snyk.io/~/changes/m2hJeDrttXy2N83AnRjM/integrations) for more details).

### **Example: Git repository integration**

To scan code from a Git-based source code repository, you must integrate Snyk to a [Git repository integration](https://docs.snyk.io/~/changes/m2hJeDrttXy2N83AnRjM/integrations/git-repository-scm-integrations). Snyk has pre-built integrations for GitHub, GitHub Enterprise, Bitbucket Cloud, and other repositories.

First, log in to the Snyk Web UI ([app.snyk.io](https://app.snyk.io)), and select **Integrations > Source control**.

<div align="left"><figure><img src="https://2533899886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdwVZ6HOZriajCf5nXH%2Fuploads%2Fk7ehjaf8xWDpFiPZZLLR%2FScreenshot%202022-07-26%20at%2013.26.22.png?alt=media&#x26;token=9c02a06a-7437-43ae-9808-91ce362561b1" alt="Select Source control integrations"><figcaption><p>Select Source control integrations</p></figcaption></figure></div>

{% hint style="info" %}
If an integration is already configured for your Organization, it is marked as **Configured**.
{% endhint %}

To connect Snyk with your GitHub repositories:

1. Choose whether to give Snyk access to both public and private repositories or only to public repositories.\
   The GitHub authorization screen opens.
2. In the GitHub authorization screen, click **Authorize Snyk** to provide Snyk with access to your repositories - enter your account credentials and save your details when prompted.

See [Git repository integrations (SCMs)](https://docs.snyk.io/~/changes/m2hJeDrttXy2N83AnRjM/integrations/git-repository-scm-integrations) for more information.

## What's next?

You can now [import a Snyk Project](https://docs.snyk.io/~/changes/m2hJeDrttXy2N83AnRjM/getting-started/quickstart/import-a-project), to tell Snyk what to scan for issues.
