> For the complete documentation index, see [llms.txt](https://daton-sarasanalytics.gitbook.io/daton/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://daton-sarasanalytics.gitbook.io/daton/integrations/data-sources/shipping-platforms/shipbob/how-to-integrate-shipbob-with-daton.md).

# How to Integrate ShipBob with Daton

This subtopic provides step-by-step instructions to create Shipbob integrations in Daton, detailing the prerequisites, the integration process, and important notes.

### Pre-requisites

Before starting, ensure you have 

1. An active Daton and ShipBob account.
2. A Personal Access Token (PAT) for your ShipBob Account.

### Task 1**:** Create an Access Token (Personal Access Token (PAT)) for Your ShipBob Account

1. [Log in](https://auth.shipbob.com/Account/Login?returnUrl=%2Fconnect%2Fauthorize%2Fcallback%3Fclient_id%3DShipBob.OneId.User%26redirect_uri%3Dhttps%253A%252F%252Fweb.shipbob.com%252Fapp%252FMerchant%252Fsignin-callback%26response_type%3Dcode%26scope%3Dopenid%2520profile%2520email%2520read%2520write%2520offline_access%2520inboundManagement_read%2520fulfillments_read%2520orders_read%2520orders_write%2520orderstateapi_read%2520receiving_read%2520receiving_write%2520returns_read%2520returns_write%2520addressValidation%2520labeling_read%2520labeling_write%2520inventory_read%2520inventory_write%2520channels_read%2520locations_read%2520locations_write%2520workOrders_read%2520workOrders_write%2520powerBIconfig_read%2520products_read%2520pricing_read%2520fulfillment_customization_write%2520fulfillment_customization_read%2520cartbob_write%2520cartbob_read%2520onboarding_read%2520onboarding_write%2520inventoryallocation_read%2520internal_integrations_read%2520internal_integrations_write%2520internal_fulfillments_write%2520fba_read%2520fba_write%2520pricing_write%2520token_management%2520products_write%2520b2bpacking_read%2520b2bpacking_write%2520membership_read%2520membership_write%26state%3D9a95274e839346e0985bf5349460b856%26code_challenge%3DEe901CPDXjOI-lAtxXS6XivmywHBB35RvePsT0Oz664%26code_challenge_method%3DS256%26shipbob_response_mode%3Dquery) to your Shipbob account.
2. On the dashboard, click **Integrations** in the left-hand navigation bar. 

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FfFrHQjGMPX4pPIor5mqe%2F5ShipbobAPI.png?alt=media&amp;token=28eec0ea-67bf-4a4a-90fa-ab3f4fa4499b" alt="" width="188"><figcaption></figcaption></figure>
3. Choose **API Tokens** from the drop-down menu to access the Personal Access Token (PAT) page.
4. Click **Generate New Token**, and a sidebar will appear on the right side of the screen.&#x20;

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FjgShKciKUdx3Ix1CHyy6%2F6ShipbobAPI.png?alt=media&amp;token=98bc317e-4c7e-4d76-8236-34eb61b82260" alt=""><figcaption></figcaption></figure>
5. Provide a **Token Name** (up to 100 characters) and a **Description** (up to 250 characters) to identify and explain the token's purpose.
   * Click **Generate Token** at the bottom right to create the PAT.&#x20;

     <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FaL9NWpmzJC0Eq20UzrMX%2F7ShipbobAPI.png?alt=media&amp;token=58c2dbb6-026f-4e5f-ad59-64701b9f7f73" alt="" width="188"><figcaption></figcaption></figure>
6. A confirmation message will appear, and an email notification will be sent to relevant users.
7. Copy the token provided as it won't be visible again in the dashboard. **Save** it securely.
8. Check the box confirming that **I have copied the token**.
9. Click **Confirm & Close** to complete the process.&#x20;

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2F1540ytz97mc66LlDPU6i%2F8ShipbobAPI.png?alt=media&amp;token=d4ec5108-723b-4578-9e37-4ea66b78d46c" alt="" width="188"><figcaption></figcaption></figure>

To know more about PAT creation and access for Shipbob, see [API Token Generation (Personal Access Token).](https://support.shipbob.com/s/article/API-Token-Generation-Personal-Access-Token#:~:text=A%20personal%20access%20token%20%28PAT%29%20contains%20your%20user,attempting%20to%20connect%20a%20platform%20to%20ShipBob%E2%80%99s%20API.)

### Task 2: Integrate Daton with ShipBob

1. Log in to your [Daton account](https://daton.sarasanalytics.com/u/integrations-list) and search for ShipBob in the list of Connectors, then click **Configure**.
2. Enter the following details and click **Authenticate**: &#x20;

   * Integration Name

   **Note** that the Integration Name will be used to create the integration tables and cannot be modified later.

   * Optionally, add a description to identify the integration.
   * Replication Frequency&#x20;
   * Replication Start Date
   * Optionally, expand the **Advanced Configuration Options** section and, based on your requirements, modify the options to control the loading behavior of Daton.

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FchHIv6NkKuQxI4y9C3PO%2F1Shipbob.png?alt=media&amp;token=bdaa98a4-4620-46c3-aa32-04d8c748e192" alt=""><figcaption></figcaption></figure>
3. Copy and paste the API token you created for your ShipBob account to authenticate the integration and extract data for replication.&#x20;

   * Then click **Authenticate**.&#x20;

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2F1hJztYVhROf4v4Vw43V6%2F2Shipbob.png?alt=media&amp;token=8b566e04-87f5-4feb-a522-5ac8cd705254" alt=""><figcaption></figcaption></figure>
4. After successful authentication, you will be prompted to choose from the list of available tables. Select the required tables and click **Next**.

   1. Optionally, based on your requirement, select specific options for each selected table.&#x20;

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2Fk0q9yH9sbXYU08F5RRs7%2F3Shipbob.png?alt=media&amp;token=5dd5b9b3-9ebb-4d67-8003-abf30cedaee1" alt=""><figcaption></figcaption></figure>
5. Select the required fields for each table and click **Submit.**&#x20;

   * **Note** that you will be prompted to select the destination for your account.

   <figure><img src="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FumBUrpllLGxzRIHRGb8A%2F4Shipbob.png?alt=media&amp;token=3edcebba-e4bc-47a1-a2c8-e572c0ba3a90" alt=""><figcaption></figcaption></figure>
6. Select the destination for your store or shop and click **Confirm**. An integration successful message will be displayed.

## Important Note

* Integrations would begin in the Pending state and change to the Active state once the first job successfully loaded data into the configured warehouse.&#x20;
* Users can check job status and process logs from the integration details page by clicking on the integration name in the active list.&#x20;
* Users can Re-Authenticate, Edit, Clone, Pause, or Delete the integration at any moment by clicking on settings. You can also adjust the frequency and history of the integration.&#x20;
* On the Sources page, click Integration to access each table in your integration. The page also shows the state of each table, the last replicated time, and Reload access buttons.&#x20;