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

# SHOPLINE (OAuth)

> Integrate your application with the SHOPLINE API via OAuth

## 🚀 Quickstart

Connect to SHOPLINE with Nango and see data flow in 2 minutes.

**1. Create the integration**

In Nango ([free signup](https://app.nango.dev)), go to the Integrations tab -> *Configure New Integration* -> *SHOPLINE (OAuth)*.

**2. Authorize SHOPLINE**

Go to the Connections tab -> *Add Test Connection* -> *Authorize*, then log in to SHOPLINE. Later, you'll let your users do the same directly from your app.

**3. Call the SHOPLINE API**

Make your first request to the SHOPLINE API. Replace the placeholders below with your Environment API key from **Environment Settings > API Keys**, integration ID (Integrations tab), and connection ID (Connections tab):

> [tab] cURL
>
> ```bash theme={null}
> curl "https://api.nango.dev/proxy/admin/openapi/v20260601/products/products.json" \
>   -H "Authorization: Bearer <NANGO-API-KEY>" \
>   -H "Provider-Config-Key: <INTEGRATION-ID>" \
>   -H "Connection-Id: <CONNECTION-ID>"
> ```

> [tab] Node
>
> Install Nango's backend SDK with `npm i @nangohq/node`. Then run:
>
> ```typescript theme={null}
> import { Nango } from '@nangohq/node';
>
> const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });
>
> const res = await nango.get({
>     endpoint: '/admin/openapi/v20260601/products/products.json',
>     providerConfigKey: '<INTEGRATION-ID>',
>     connectionId: '<CONNECTION-ID>'
> });
>
> console.log(res.data);
> ```

Or fetch credentials with the [Node SDK](https://nango.dev/docs/reference/backend/backend-sdk/node.md#get-a-connection-with-credentials) or [API](https://nango.dev/docs/reference/backend/http-api/connections/get.md).

✅ You're connected! Check the Logs tab in Nango to inspect requests.

**4. Implement Nango in your app**

Follow our [Auth implementation guide](https://nango.dev/docs/guides/primitives/auth.md) to integrate Nango in your app.

To obtain your own credentials, follow the setup guide linked below.

## 📚 SHOPLINE (OAuth) Integration Guides

Nango-maintained guides for common use cases.

* [How to register your own SHOPLINE OAuth app](https://nango.dev/docs/api-integrations/shopline-oauth/how-to-register-your-own-shopline-oauth-app)\
  Register an app on the SHOPLINE Partner Portal and obtain your OAuth client ID and secret.

* [How do I link my account?](https://nango.dev/docs/api-integrations/shopline-oauth/connect)\
  Connect your SHOPLINE store using the Connect UI

Official docs: [SHOPLINE app authorization](https://developer.shopline.com/docs/apps/api-instructions-for-use/app-authorization/)

> [!NOTE]
>
> Register a **Public app** with SHOPLINE, not a Custom app — Custom apps are scoped to a single merchant, so they can't be installed by multiple merchants.
>
> For merchants who'd rather skip app registration entirely, see the simpler [SHOPLINE](https://nango.dev/docs/api-integrations/shopline.md) integration, which uses a static admin-generated access token instead of OAuth.

## 🧩 Pre-built syncs & tools for SHOPLINE (OAuth)

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs.

### Others

| Function name | Description | Type |
| - | - | - |
| `add-order-risk` | Add a fraud risk flag to an order. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-product-to-collection` | Link one product to one collection (creates a single "collect" relationship row). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `adjust-inventory-level` | Adjust an inventory item's available quantity at a location by a relative delta. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `bulk-add-products-to-collection` | Add multiple products to a manual collection in one call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `bulk-remove-products-from-collection` | Remove multiple products from a manual collection in one call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `cancel-fulfillment` | Cancel a fulfillment. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `cancel-order` | Cancel an order. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-customer-address` | Add a new address to a customer. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-customer` | Create a customer. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-discount-code` | Create a redeemable discount code under a price rule | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-fulfillment` | Create a fulfillment for an order's line items, with optional tracking info. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-manual-collection` | Create a manual (custom) collection. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-order` | Create an order directly (not a draft/checkout flow). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-price-rule` | Create a discount price rule. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-product-image` | Add an image to a product from a URL | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-product-variant` | Create a new variant on a product. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-product` | Create a product. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-smart-collection` | Create a smart collection with membership rules. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-customer-address` | Delete a customer address. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-customer` | Delete a customer. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-discount-code` | Delete a discount code. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-manual-collection` | Delete a manual collection. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-order` | Permanently delete an order. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-price-rule` | Delete a price rule. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-product-image` | Delete a product image | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-product-variant` | Delete a product variant. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-product` | Delete a product. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-smart-collection` | Delete a smart collection. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-collection-product-link` | Retrieve a single product-collection relationship ("collect") by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-customer-address` | Retrieve a single customer address by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-customer-count` | Get the total count of customers. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-customer` | Retrieve a single customer by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-discount-code-by-code` | Look up a discount code by the code string itself (not its ID or price rule). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-discount-code` | Retrieve a single discount code by its ID (scoped to its price rule). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-inventory-item` | Retrieve a single inventory item by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-inventory-levels` | Get available inventory quantities for inventory items, optionally scoped to locations. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-location` | Retrieve a single location by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-manual-collection` | Retrieve a single manual collection by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-order-count` | Get the total count of orders, optionally filtered. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-order-fraud-risks` | List fraud risk assessments for an order. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-order-transactions` | Query payment transactions for an order. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-order` | Retrieve a single order (via list-orders scoped by the ids param - no dedicated single-order endpoint exists). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-price-rule` | Retrieve a single price rule by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-product-count` | Get the total count of products, optionally filtered. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-product-image` | Retrieve a single product image by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-product-variant` | Retrieve a single product variant by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-product` | Retrieve a single product by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-smart-collection` | Retrieve a single smart collection by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-collection-product-links` | List product-collection relationships ("collects"), filterable by product or collection. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-customer-addresses` | Batch-fetch addresses for one or more customers by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-customers` | List customers with filtering and pagination. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-discount-codes-for-price-rule` | List all discount codes attached to a given price rule. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-inventory-items` | Retrieve inventory items by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-locations` | List all store locations. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-manual-collections` | List manual (custom) collections. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-order-fulfillments` | List all fulfillments for an order. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-order-refunds` | List refunds associated with an order | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-orders` | List orders with filtering and pagination. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-price-rules` | List discount price rules with filtering and pagination. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-product-images` | List images for a product by image IDs. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-product-variants` | List variants for a product. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-products-in-collection` | List products belonging to a collection (manual or smart). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-products` | List products with filtering and pagination. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-smart-collections` | List smart (intelligent, rule-based) collections. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-order-risk` | Remove a fraud risk assessment from an order. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-product-from-collection` | Remove a single product-collection relationship ("collect") by its ID | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-customers` | Fuzzy/structured search for customers. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `set-default-customer-address` | Mark an address as a customer's default. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `set-inventory-level` | Set an inventory item's available quantity at a location to an absolute value. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-customer-address` | Update an existing customer address. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-customer` | Update a customer's fields. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-discount-code` | Update a discount code. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-fulfillment-tracking` | Update (overwrite) tracking info on an existing fulfillment. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-inventory-item` | Update an inventory item (e.g. enable tracking, set cost). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-manual-collection` | Update a manual collection's fields. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-order-risk` | Update an existing fraud risk assessment on an order. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-order` | Update an order's fields (notes, tags, contact info, shipping address). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-price-rule` | Update a price rule's fields. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-product-image` | Update a product image's metadata (alt text, position, variant association). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-product-variant` | Update a product variant's fields. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-product` | Update a product's fields, including adding options, variants, and media. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-smart-collection` | Update a smart collection's fields or rules. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `customers` | Sync customers, including embedded addresses and marketing consent | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `discount-codes` | Sync discount codes (the redeemable code strings), scoped per price rule. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `locations` | Sync store locations. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `manual-collections` | Sync manual (custom) collections from SHOPLINE | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `orders` | Sync orders, including embedded line items, fulfillments, refunds, and payment details. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `price-rules` | Sync discount price rules (the rule/scope/value definitions backing discount codes). | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `products` | Sync products, including their embedded variants, options, and images/media. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `smart-collections` | Sync smart (intelligent, rule-based) collections. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.