Skip to main content

Integrations Overview

Velane integrations are designed so snippet code can call provider APIs without handling OAuth tokens directly.

How it works​

  1. You configure and connect a provider in the admin portal
  2. Velane stores connection metadata for your tenant
  3. Snippets call the built-in integrations client
  4. Velane proxies requests to the provider through its internal integration path

This keeps credentials out of snippet code and centralizes OAuth lifecycle handling.

Connect a provider​

In the admin portal:

  1. Go to Integrations
  2. Choose a provider (for example, GitHub or Salesforce)
  3. Configure OAuth app details if required
  4. Complete the Connect flow

After connection, snippets in your tenant can call that provider.

Use integrations in Bun snippets​

import { integration } from '@velane/integrations'

export default async function handler() {
  const github = integration('github')
  return await github.get('/user')
}

Use integrations in Python snippets​

from velane.integrations import integration

def handler(_input):
    github = integration("github")
    return github.get("/user")

Why this model is useful​

  • no token refresh logic in snippets
  • one usage pattern across many providers
  • easier agent-generated code with fewer auth mistakes

Next step​

If you are using Cursor or Claude Code, continue to MCP Overview for the MCP-first workflow.