Prerequisites
Before you start, make sure you have:- Merchant account: Provisioned by Quivo.
- Connector Web App access: Ability to sign in to The Connector.
- API credential: A client ID and client secret. An Account Admin creates it in The Connector.
- Seller ID: Your merchant identifier needed for API operations.
If you need a merchant account or Connector access, contact Quivo support.
Access The Connector
- Sign in to The Connector Web App with your Quivo credentials:
- Production: https://app.quivo.co/
- Sandbox: https://app-sandbox.quivo.co/
- Manage logistics operations and create API credentials for your integrations in the web app.
Credential model
- API credential: A client ID (it starts with
qak_) and a client secret. Your integration uses it to get access tokens. It is not a Connector user login. - Access token: Obtained via
POST /v2/oauth2/token; valid for one hour. Send it in theAuthorization: Bearerheader on every call to/v2/.... - No API key: With an API credential you do not send an
X-Api-Keyheader.
POST /login with a Connector username, password and the X-Api-Key header still work. This method is deprecated and works until 31 January 2027. From 1 February 2027, integrations need an API credential. See Migrate to OAuth 2.0 API credentials.
For authentication flows and header examples, see the Authentication guide.
Getting an API credential
- An Account Admin creates API credentials for their sellers in The Connector, under Admin › API Credentials. No approval from Quivo is needed.
- The separate How-To guide, Create an API credential, covers creating, rotating and revoking credentials step by step.
Find your Seller ID
- Your Seller ID uniquely scopes API operations to your merchant account.
- Retrieve it via the
GET /sellers endpointafter you have an access token.
Choose your environment
- Use the correct
${BASE_URL}configured for your account:- Production:
https://api.quivo.co - Sandbox:
https://api-sandbox.quivo.co
- Production:
- Keep base URLs, API credentials, and access tokens separate per environment. A credential belongs to one environment.
Where to go next
Make your first API call
Learn how to authenticate and make your first API call to verify your setup.
Send Inventory
Send your products to Quivo warehouses to make them available for fulfillment.