Skip to main content
POST
/
mcp-server
/
self-hosted
/
instance
/
create
Create
curl --request POST \
  --url https://api.klavis.ai/mcp-server/self-hosted/instance/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "serverName": "Affinity",
  "userId": "<string>"
}
'
{
  "instanceId": "<string>",
  "oauthUrl": "<string>"
}

Authorizations

​
Authorization
string
header
required

Your Klavis AI API key.

Body

application/json
​
serverName
enum<string>
required

The name of the target MCP server. Case-insensitive (e.g., 'google calendar', 'GOOGLE_CALENDAR', 'Google Calendar' are all valid).

Available options:
Affinity,
Airtable,
Asana,
Attio,
Box,
Brave Search,
Cal.com,
Canva,
ClickUp,
Close,
Cloudflare,
Coinbase,
Confluence,
Dialpad,
Discord,
Doc2markdown,
DocuSign,
Dropbox,
ElevenLabs,
Exa,
Fathom,
Figma,
Fireflies,
Firecrawl Deep Research,
Firecrawl Web Search,
Freshdesk,
GitHub,
GitLab,
Gmail,
Gong,
Google Calendar,
Google Docs,
Google Drive,
Google Jobs,
Google Sheets,
Hacker News,
Heygen,
HubSpot,
Jira,
Klaviyo,
Klavis ReportGen,
Linear,
LinkedIn,
Markdown2doc,
Mem0,
Microsoft Teams,
Mixpanel,
Monday,
Moneybird,
Motion,
Notion,
OneDrive,
Openrouter,
Outlook Mail,
Outlook Calendar,
PagerDuty,
Pipedrive,
Plai,
Postgres,
PostHog,
Postman,
QuickBooks,
Resend,
Salesforce,
SendGrid,
Shopify,
Slack,
Stripe,
Supabase,
Tavily,
Vercel,
WhatsApp,
WordPress,
YouTube,
Zendesk,
ServiceNow
​
userId
string
required

The unique identifier for the user. The server instance along with the all the authentication data will belong to that specific user only. It can be a UUID from the database, a unique email address from the user, etc.

Minimum string length: 1

Response

Successful Response

​
instanceId
string
required

The unique identifier for this specific server connection integration instance.

​
oauthUrl
string | null

The OAuth authorization URL for the specified server, if OAuth is configured.