Foundations

Connections
Get API Keys

The Connection object

The Connections endpoints are used to manage Connections, which are the individual storefronts, payment processors, or accounting systems that businesses have shared with you. You can use these endpoints to create a new connection manually and send an authentication link directly to a merchant, or get access to the raw credentials for a specific platform (Shopify, WooCommerce, Quickbooks Online, etc.).

To understand the lifecycle of a Connection and the important events that occur when a merchant connects/disconnects their platform, see Connection Lifecycle.

Properties

idstring

The UUID of the connection. Generated by Rutter.

orgIdstring

Your organization id.

platformenum

The underlying platform.

One ofSHOPER, SHOPIFY, SHOPWARE, MAGENTO, BIG_COMMERCE, WOO_COMMERCE, SQUARESPACE, WIX, SQUARE, COMMERCELAYER, AMAZON, ETSY, EBAY, PRESTASHOP, WEBFLOW, LAZADA, FNAC, ALIBABA, SHOPEE, MERCADOLIBRE, GUMROAD, SHOPLAZZA, SHOPLINE, WALMART, STRIPE, MOLLIE, PAYPAL, QUICKBOOKS, QUICKBOOKS_DESKTOP, ECWID, XERO, FRESHBOOKS, NETSUITE, SAGE_BUSINESS_CLOUD, SAGE_INTACCT, ZOHOBOOKS, WAVE, DYNAMICS365, CHARGIFY, CHARGEBEE, RECURLY, or PLAID.
Example Connection Object
{
  "id": "00000000-0000-0000-0000-000000000000",
  "orgId": "00000000-0000-0000-0000-000000000000",
  "platform": "SHOPIFY"
}

Create a Connection

POST /connections/create
Supported for: AmazonBigCommerceEbayFnacLazadaMagentoNetSuitePrestaShopQuickBooksShoperShopifySquareStripeWalmartWooCommerce

Create connections programmatically using the Create a Connection API. There are two ways to use this API:

  • Create a connection that allows the merchant to select which platform they want to connect. This is done by leaving the request body empty.
  • Create a connection with existing credentials. This is done by specifying the platform and including the associated credentials (OAuth, Basic Auth, etc.) for the connection. Rutter will use these fields to make the authenticated API requests to the platform. To see what values are required for each platform, see the Platform Specific Required Body Params table below or contact support@rutterapi.com for more support.

Request Body

    All of:

    platformenum

    The underlying platform.

    One ofBIG_COMMERCE, AMAZON, SHOPIFY, PRESTASHOP, SHOPER, WOO_COMMERCE, MAGENTO, EBAY, LAZADA, FNAC, SQUARE, STRIPE, QUICKBOOKS, NETSUITE, or WALMART.
    scopestringoptional

    Any of:

    Credentials for BigCommerce

    oauth_client_idstringoptional

    BigCommerce App Client ID

    oauth_access_tokenstring

    BigCommerce Store Access Token

    store_urlstring

    BigCommerce merchant .mybigcommerce.com domain URL

    oauth_client_secretstringoptional

    BigCommerce App Client Secret

    Credentials for Amazon

    amazon_access_key_idstring

    AWS User Access Key ID

    oauth_client_idstring

    SP-API App Client ID

    amazon_secret_access_keystring

    AWS User Secret Access Key

    amazon_seller_regionenum

    Region of Amazon seller - must be one of na (North America), eu (Europe), or fe (Far East).

    One ofna, eu, or fe.
    amazon_selling_partner_rolestring

    AWS Role ARN used in SP-API app

    oauth_client_secretstring

    SP-API App Client Secret

    oauth_refresh_tokenstring

    SP-API Refresh Token

    Any of:

    Credentials for Shopify Private App

    basic_passwordstring

    Private Shopify App Password

    basic_usernamestring

    Private Shopify App API Key

    store_urlstring

    Shopify merchant .myshopify.com domain URL

    Credentials for Shopify Public App

    oauth_client_idstring

    Shopify Public App Client ID

    oauth_access_tokenstring

    Shopify Merchant Access Token

    oauth_client_secretstring

    Shopify Public App Client Secret

    store_urlstring

    Shopify merchant .myshopify.com domain URL

    Credentials for PrestaShop

    api_keystring

    PrestaShop API Key

    store_urlstring

    PrestaShop merchant domain URL

    Credentials for Shoper

    oauth_access_tokenstring

    Shoper merchant OAuth Access Token

    oauth_refresh_tokenstring

    Shoper merchant OAuth Refresh Token

    store_urlstring

    Shoper merchant domain URL

    Credentials for WooCommerce

    basic_passwordstring

    WooCommerce Rest API Consumer Secret

    basic_usernamestring

    WooCommerce Rest API Consumer Key

    store_urlstring

    WooCommerce merchant website URL

    Credentials for Magento

    basic_passwordstring

    Magento Admin User Password

    basic_usernamestring

    Magento Admin User Username

    store_urlstring

    Magento merchant website URL

    Credentials for eBay

    oauth_client_idstring

    Ebay Developer OAuth Client ID

    oauth_client_secretstring

    Ebay Developer OAuth Client Secret

    oauth_refresh_tokenstring

    Ebay OAuth Refresh Token

    Credentials for Lazada

    oauth_client_idstring

    OAuth Client ID

    countrystring

    Country Code for Merchant (e.g. id, sg, th)

    oauth_access_tokenstring

    OAuth Access Token

    oauth_client_secretstring

    OAuth Client Secret

    oauth_refresh_tokenstring

    OAuth Refresh Token

    Credentials for Fnac

    partner_idstring

    Partner ID

    shop_idstring

    Shop ID

    keystring

    Key

    Credentials for Square

    oauth_client_idstring

    Square Developer OAuth Client ID

    oauth_client_secretstring

    Square Developer OAuth Client Secret

    oauth_refresh_tokenstring

    Square OAuth Refresh Token

    Credentials for Stripe

    account_idstring

    Stripe Account ID

    oauth_access_tokenstring

    Stripe OAuth Access Token

    Credentials for Quickbooks

    oauth_client_idstring

    OAuth Client ID

    realm_idstring

    Realm ID

    oauth_client_secretstring

    OAuth Client Secret

    oauth_refresh_tokenstring

    OAuth Refresh Token

    environmentstringoptional

    Environment (e.g. sandbox)

    Credentials for Netsuite

    token_idstring

    Token ID

    consumer_keystring

    Consumer Key

    consumer_secretstring

    Consumer Secret

    public_keystring

    Public Key

    store_namestring

    Store Name

    token_secretstring

    Token Secret

    Credentials for Walmart

    oauth_client_idstring

    Walmart Developer OAuth Client ID

    oauth_client_secretstring

    Walmart Developer OAuth Client Secret

Response Body

    connectionobject
    Show connection attributes
Example Response Body
{
  "connection": {
    "id": "00000000-0000-0000-0000-000000000000",
    "access_token": "00000000-0000-0000-0000-000000000000",
    "link_url": "https://link.rutterapi.com/connection/00000000-0000-0000-0000-000000000000"
  }
}

List Connections

GET /connections
Supported for: All Platforms

Response Body

    connectionsarray
    Show connections attributes

Fetch a Connection

GET /connections/access_token
Supported for: AmazonBigCommerceChargebeeChargifyDynamics 365EbayEtsyFresh BooksLazadaMagentoMercado LibreNetSuitePayPalPrestaShopQuickBooksQuickBooks DesktopRecurlySage Business CloudSage IntacctShopeeShoperShopifyShopwareSquareSquarespaceStripeWalmartWaveWixWooCommerceXeroZoho Books

Request Parameters

    access_tokenstringquery

    The access token of the connection.

Response Body

    connectionobject
    Show connection attributes

Fetch a Connection Status

GET /connections/status
Supported for: All Platforms

Request Parameters

    access_tokenstringquery

    The access token of the connection.

Response Body

    connectionobject
    Show connection attributes
    statusobject
    Show status attributes

Delete a Connection

DELETE /connections/:id
Supported for: All Platforms

Request Parameters

    idstringpath

    The Rutter connection ID to delete.

Response Body

    successboolean

    true if the delete operation succeeded.

Example Response Body
{
  "success": true
}
Next
Tokens