# BigCommerce

This guide is intended for BigCommerce merchants who are connecting their store to Violet. During this process, the merchant will create a Store-level API account in their BigCommerce dashboard and then provide the generated credentials to Violet through the Violet Connect onboarding tool. The merchant will retain full control of the created Store-level API account and can modify or remove it at any time from within the BigCommerce dashboard.*Total time for completion is around 5 minutes.*

{% embed url="<https://player.vimeo.com/video/1061362956>" %}

## Step 1: Creating the Store-level API Account

1. From your BigCommerce dashboard navigate to Settings → API → Store-level API accounts.
2. Click the blue Create API account button.
3. In the modal that appears, enter an account name (ex. Violet)

![](/files/1ZmvNc2KNK2HB04HSgQ2)

***

## Step 2: Configuring Scopes

The following OAuth scopes are the minimum required for Violet to perform all necessary functions with your store.

`Customers modify` - used to add new customers when performing non-guest checkouts.

`Information & settings read-only` - used to read the store profile for plan type, supported currencies, and measurement units.

`Orders modify` - used to update and read orders previously submitted by Violet into your system.

`Products read-only` - used to read your product catalog.

`Carts modify` - used to create carts for checkout.

`Checkouts modify` - used to checkout carts.

![](/files/glEuywCtV6YnNGvTKYza)

## Step 3: API Credentials

Click **Save** at the bottom of the 'Create account' page.

You will be presented with a modal showing generated BigCommerce API credentials. Important: these values can only be viewed once. It’s recommended that you copy and paste it into a temporary location until you finish the Violet onboarding process. If you lose these values before completing the Violet onboarding process you must start-over with a new Store-level API account.

**Client ID**

This key is used to identify Violet as the origin of any API requests made against your BigCommerce store.

**Client secret**

This key is used to verify the signatures of any data sent from your BigCommerce store to Violet.

**Access token**

This key is used to authenticate any API requests made by Violet against your BigCommerce store.

![](/files/vLZksMz1LqxfFMleIiuE)

## Step 4: Provide BigCommerce API credentials to Violet

Once you have generated the API credentials, it’s time to return to the Violet Connect onboarding tool and enter the following credentials created in the previous steps:

* Client ID
* Client secret
* Access Token

Once entered, click the **Next** button to validate the credentials and complete the connection between your store and Violet. If the credentials are invalid you should check for any spaces or other copy/paste errors and try again.

![](/files/ti43j1bBPcFA6Eu1fD9c)

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://merchant-help.violet.io/platform-guides/big-commerce.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.