Search
K

Getting Started

A 5-minute tour from "I just created an account" to "I made my first API call."

1. Register an application

Inside the portal:

  1. Click your profile icon → My Applications.
  2. Hit + New Application and give it a name (e.g. My USBC integration).
  3. Pick an environment — start with Sandbox.
  4. Subscribe the app to the API(s) you need. See Environments for the difference between Sandbox and Production catalogs.

Konnect generates a client_id and client_secret on creation. Copy the secret now — it isn't shown again.

2. Exchange credentials for a token

See the full flow in Authentication. Short version:

curl -X POST https://api.kong.globalid.dev/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "<your-client-id>",
    "client_secret": "<your-client-secret>"
  }'

Save the returned access_token. Tokens last 1 hour by default.

3. Make your first request

curl https://api.kong.globalid.dev/v1/users/me \
  -H "Authorization: Bearer <access_token>"

If you get 200 OK with a JSON body, you're set. If you get 401, double-check the token format. If you get 429, see Errors & Rate Limits.

What's next

  • Browse the full API surface under APIs — pick any spec to try requests in the in-browser console.
  • Set up webhooks if your integration needs server-side notifications: Webhooks.
  • Plan your Production migration: Environments.