Skip to main content

Easily Integrate
Sellsy's API using Konfig's TypeScript SDK

Need a TypeScript SDK for Sellsy's API?

Growing API Companies trust Konfig's SDKs to onboard developers to their API.

SnapTradeHumanloopSplititLeapGroundx

First, instantiate the SDK

It only takes a few lines of code.

index.ts

import { Sellsy } from 'sellsy-typescript-sdk';
const sellsy = new Sellsy({
/*
* ### Client OAuth
* You can generate a new OAuth 2 client for the V2 API, from the developer page of your Sellsy account (https://www.sellsy.fr/developer/api-v2).
*
* Several types of clients are available:
*
* - **Private:** API access limited to staffs of your SELLSY account.
* A flow by authorization code will be required
* - **Personal**: API access linked to an staff.
* The use of client credentials flow is possible.
* - **Public**: API access to connect to all SELLSY accounts.
* A validation of SELLSY and a flow by authorization code will be required.
*
* ### Authorization Code Flow
* See https://www.oauth.com/oauth2-servers/server-side-apps/authorization-code/
*
* **PKCE** is required when using the authorization code flow. https://www.oauth.com/oauth2-servers/pkce/
*
* - **Authorization URL:** https://login.sellsy.com/oauth2/authorization
* - **Token URL:** https://login.sellsy.com/oauth2/access-tokens
* - **Refresh URL:** https://login.sellsy.com/oauth2/access-tokens
*
*
* #### Example:
* Call `https://login.sellsy.com/oauth2/authorization?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&code_challenge=YOUR_PKCE_CODE_CHALENGE&code_challenge_method=S256`
*
* After authentication, a redirection will be performed on the redirection uri. The authaurization code will be retrieved in the query parameter `code` .
*
* This code can now be exchanged for an access token:
* ```bash
* curl -X POST \
* https://login.sellsy.com/oauth2/access-tokens \
* -d '{
* "grant_type": "authorization_code",
* "client_id": "YOUR_CLIENT_ID",
* "redirect_uri": "YOUR_REDIRECT_URI",
* "code_verifier": "YOUR_PKCE_CODE_VERIFIER",
* "code": "THE_CODE"
* }'
* # Response
* {
* "token_type": "Bearer",
* "expires_in": 3600,
* "access_token": "YOUR_ACCESS_TOKEN",
* "refresh_token": "YOUR_REFRESH_TOKEN"
* }
* # Use API
* curl -X GET \
* 'https://api.sellsy.com/v2/teams' \
* --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
* ```
*
* You can request a new access token, from the refresh token previously retrieved:
* ```bash
* curl -X POST \
* https://login.sellsy.com/oauth2/access-tokens \
* -d '{
* "grant_type": "refresh_token",
* "client_id": "YOUR_CLIENT_ID",
* "client_secret": "YOUR_CLIENT_SECRET"
* "refresh_token": "YOUR_REFRESH_TOKEN"
* }'
* # Response
* {
* "token_type": "Bearer",
* "expires_in": 3600,
* "access_token": "YOUR_NEW_ACCESS_TOKEN",
* "refresh_token": "YOUR_NEW_REFRESH_TOKEN"
* }
* ```
*
* ### Client Credential Flow
* See https://www.oauth.com/oauth2-servers/access-tokens/client-credentials/
*
* Only personal clients can use this authentication flow.
*
* **Token URL:** https://login.sellsy.com/oauth2/access-tokens
*
* #### Example:
* ```bash
* curl -X POST \
* https://login.sellsy.com/oauth2/access-tokens \
* -d '{
* "grant_type": "client_credentials",
* "client_id": "YOUR_CLIENT_ID",
* "client_secret": "YOUR_CLIENT_SECRET"
* }'
* # Response
* {
* "token_type": "Bearer",
* "expires_in": 3600,
* "access_token": "YOUR_ACCESS_TOKEN"
* }
* # Use API
* curl -X GET \
* 'https://api.sellsy.com/v2/teams' \
* --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
* ```
* ### Tokens expiration
* - **Authorization Code:** 10 min
* - **Access Token:** 24 hours
* - **Refresh Token:** 60 days
*/
clientId: "CLIENT_ID",
clientSecret: "CLIENT_SECRET"
})

Then, send your first request

We made it really easy.

index.ts

// Comments List
const getListResponse = sellsy.comments.getList({
direction: "asc"
limit: 25
order: "id"
})

Enjoy a buttery smooth developer experience with 351 SDK methods

How Konfig Works

Konfig collects APIs and automatically generates SDKs so you can focus on building your application.

openapi-examples

Konfig maintains the highest quality collection of OpenAPI Specifications on the internet in a GitHub repository

We pull OpenAPI Specifications from public sources, fix any errors, and make sure they pass our lint rules. We continually make sure the repository is up-to-date and collect up-time and response time metrics for every API.

openapi-examples-to-konfig

Generates AI-Augmented SDKs from openapi-examples

Our SDK generator is trusted by growing API companies and goes through a rigorous testing process to ensure the generated SDKs are high-quality and easy to use.

konfig-to-package-managers

Publishes to standard package managers

We publish to standard package managers like npm, PyPI, and Maven so you can easily integrate the SDK into your application.

Sellsy

About Sellsy

Sellsy is a CRM, invoicing and pre-accounting suite for optimized business management and customer experience. A collaborative tool to give marketing, sales and administrative teams the means to be effective! 🚀 With 6,300 clients, Sellsy surrounds itself with almost 130 employees to carry out its projects. Sellsy remains, above all, a French company created by two entrepreneurs, Frédéric Coulais and Alain Mevellec, for entrepreneurs. Since its creation in 2009, Sellsy has placed innovation at the heart of its strategy, in order to offer companies simple, efficient and secure digital solutions. 👉 To learn more about Sellsy and its CRM suite, visit go.sellsy.com

Keywords

crm
invoicing

Start integrating Sellsy's API with Konfig