Back to API Overview

App Connections API

Manage connected app accounts and third-party integrations.

3 endpoints

Endpoints

POST
/api/v1/appAccount/create

Connect a new app account. Params: mcpServerId (required, from mcpServer.list), connectionName (required), credentials (object with API keys/tokens).

Parameters

mcpServerIdstringrequired
connectionNamestringrequired
credentialsobjectrequired

Example Request

curl -X POST https://app.serenitiesai.com/api/v1/appAccount/create \
  -H "Authorization: Bearer mk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "mcpServerId": "example",
  "connectionName": "example",
  "credentials": {}
}'
POST
/api/v1/appAccount/list

List connected app accounts (OAuth integrations). Optional param "mcpServerId" to filter. Returns accounts with connection status.

Parameters

mcpServerIdstring

Example Request

curl -X POST https://app.serenitiesai.com/api/v1/appAccount/list \
  -H "Authorization: Bearer mk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "mcpServerId": "example"
}'
POST
/api/v1/appAccount/delete

Disconnect an app account. Param "appAccountId".

Parameters

appAccountIdstringrequired

Example Request

curl -X POST https://app.serenitiesai.com/api/v1/appAccount/delete \
  -H "Authorization: Bearer mk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "appAccountId": "example"
}'
App Connections API - Serenities