Authorization

Konnect API reference (1.0.0)

Welcome to the Fynd Konnect API Reference, a resource designed for quickly testing and exploring the functionality offered by Fynd Konnect. This reference provides:

  • Schema Definitions: Clear, concise data models for requests and responses to facilitate debugging and prototyping API integrations

  • Try It Console: Interactive testing directly from the documentation, enabling real-time experimentation with endpoints, response examination, and setup validation

  • Endpoint Overview: A structured catalog of Fynd Konnect APIs (Authorization, Catalog, Pricing, Inventory, Orders, Returns) for streamlined discovery and usage

Dive into how Fynd Konnect can support operational and technical needs in a sandboxed, experimentation-friendly environment

Fynd Konnect is a unified platform built to streamline e-commerce and omni-channel operations by connecting seller's downstream systems (WMS, ERP, POS) with the the top marketplaces and webstores alongside Fynd Commerce

Download OpenAPI description
konnect.json
konnect.yaml
Languages
Servers
Fynd Konnect [Sandbox]
https://fyndkonnect.konnect.uat.fyndx1.de/
Ginesys <> Konnect [Sandbox]
https://ginesys.konnect.uat.fyndx1.de/
Unicommerce <> Konnect [Sandbox]
https://unicommerce.konnect.uat.fyndx1.de/

Authorization

  • Provides endpoints for obtaining and managing authentication tokens Supports both Company-Level and Location-Level authorization modes, giving you fine-grained access control across multiple stores or warehouses
  • Integrate seamlessly with Fynd Konnect by exchanging your credentials for time-bound access tokens, ensuring secure interactions with all other APIs
Operations

Generate Access Token

Request

Exchange your credentials for an x-access-token that authorizes subsequent calls to Fynd Konnect APIs. Critical to ensure secure data exchange. Integrate this token into your request headers for endpoints like Catalog, Pricing Inventory, Orders, and Returns.

Query
usernamestringrequired

Company or Store-level integration username

passwordstringrequired

Company or Store-level integration token/password

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/aggregator/v1/token?password=string&username=string'

Responses

Successful authorization

Bodyapplication/json
access_tokenstringrequired

Token used for API authorization

statusstringrequired

Status of the API call

Response
application/json
{
  "access_token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI2NzJjODc1MzdiZWJjYzZkMWQ1MTdhZDMiLCJpYXQiOjE3MzI4NjE1OTksInJvbGUiOlsiUk9MRV9DT01QQU5ZIl0sImV4cCI6MTczMjk2MTU5OH0.6JZ-NgVn3V5duyQsrq30sODAfWY-bhMvzUxS6DYV-erfedufnb3413ewqdW341Vrwe24w1esqdsdqwe2",
  "status": "SUCCESS"
}

Catalog

  • Lets a partner maintain and retrieve detailed product listings in the Fynd OMS Includes endpoints to fetch the total SKU count and specific product listings with pagination or SKU filters

  • Ideal for validating data synchronization, bulk updates, or verifying new product onboarding

Operations

Pricing

  • Offers a way to set or update the MRP and ESP for your SKUs on a per-location basis, ensuring pricing uniformity across your internal systems and the Fynd platform
  • Supports high-volume updates (up to 500 records) in one call, streamlining real-time price adjustments for flash sales, promotions, or omni-channel pricing consistency
Operations

Inventory

  • Enables real-time stock-level management in the Fynd OMS. Update inventory quantities for each SKU across multiple locations, ensuring that Fynd accurately reflects item availability. Prevent overselling or stockouts by syncing frequently
  • Maximum 500 records can be updated in a single request
Operations

Orders

  • Covers the entire end-to-end lifecycle of orders on Fynd, from initial retrieval through packing, dispatching, and final delivery. Includes:

    • Fetching new or updated orders

    • Cancellation of orders or specific items before invoicing

    • Confirmation of orders in bulk

    • Invoicing or credit note generation

    • Make order pack and dispatch calls

    • AWB and courier updates for self-ship scenarios

    • Order status transitions for self-ship scenarios (bag_picked, delivery_done, etc.)

  • Maximum 20 records can be updated in a single request

Operations

Returns

  • Manages the reverse and RTO (Return to Origin) journeys for your orders:

    • Fetch returns by using GET Orders endpoint with RETURN_DELIVERED as the order status
    • Quality Check acceptance after items are returned to the seller
    • Credit Note issuance for returns or RTO using the PUT Update Inventory endpoint with "invoiceType: return"

  • All reverse processes remain in sync with Fynd OMS

  • Maximum 20 records can be updated in a single request

Operations
© 2025 Shopsense Retail Technologies | MadeInIndia