Skip to Content
DocumentationGetting Started

Getting Started

Welcome to the Kesk Developer Platform. This guide will help you set up your development environment and make your first API call.

Prerequisites

Before you begin, ensure you have:

  • A Kesk developer account
  • API credentials (Client ID and Secret)
  • A development environment with HTTP client capabilities

Step 1: Create a Developer Account

  1. Visit developers.kesk.app 
  2. Click “Sign Up” and complete the registration
  3. Verify your email address
  4. Complete your developer profile

Step 2: Generate API Credentials

After logging in to your developer dashboard:

  1. Navigate to “API Keys” section
  2. Click “Create New Key”
  3. Select your application type
  4. Save your Client ID and Client Secret securely

Important: Never expose your Client Secret in client-side code or public repositories.

Step 3: Authentication

All API requests require authentication using OAuth 2.0. Here’s how to obtain an access token:

curl -X POST https://api.kesk.app/oauth/token \ -H "Content-Type: application/json" \ -d '{ "grant_type": "client_credentials", "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET" }'

Response:

{ "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...", "token_type": "Bearer", "expires_in": 3600 }

Step 4: Make Your First Request

With your access token, you can now make API requests:

curl -X GET https://api.kesk.app/v1/merchants \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json"

Next Steps

  • Explore the API Reference for all available endpoints
  • Set up Webhooks for real-time notifications
  • Download our SDKs for your preferred language
  • Follow our Guides for specific use cases