MCP Gateway

Create a new OAuth app from a template with encrypted client credentials. The app inherits default configuration from the template but can override settings.

Authorization

User API Key

AuthorizationBearer <token>

User API key (mgw_usr_live_* or mgw_usr_test_*)

In: header

access_token?|

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

alias*string

Unique alias for the OAuth app (used in URLs)

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$

Length2 <= length <= 100

name*string

Display name for the OAuth app

Length1 <= length <= 255

template_id*string

ID of the OAuth app template to use

Formatuuid

client_id*string

OAuth client ID from the provider

Length1 <= length

client_secret*string

OAuth client secret (will be encrypted at rest)

Length1 <= length

scopes?array<>|

Custom scopes (overrides template default)

auth_url?|

Custom auth URL (overrides template)

token_url?|

Custom token URL (overrides template)

tenant_id?|

Microsoft 365: Azure AD tenant ID

instance_url?|

Salesforce: Instance URL

gitlab_base_url?|

GitLab: Base URL for self-hosted instances

hubspot_app_id?|

HubSpot: App ID

authorization_server_url?|

Authorization server URL for matching (e.g., https://accounts.google.com)

is_global?boolean

Whether this app is available to all servers

Defaultfalse

is_enabled?boolean

Whether the app is enabled

Defaulttrue

additional_config?|

Additional provider-specific configuration

Response Body

`application/json`

curl -X POST "https://loading/api/v1/oauth-apps" \  -H "Content-Type: application/json" \  -d '{    "alias": "string",    "name": "string",    "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",    "client_id": "string",    "client_secret": "string"  }'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc",
  "alias": "string",
  "name": "string",
  "client_id": "string",
  "client_secret_masked": "string",
  "auth_url": "string",
  "token_url": "string",
  "scopes": [
    "string"
  ],
  "tenant_id": "string",
  "instance_url": "string",
  "gitlab_base_url": "string",
  "hubspot_app_id": "string",
  "authorization_server_url": "string",
  "is_global": true,
  "is_enabled": true,
  "additional_config": {},
  "template_type": "github",
  "template_name": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "created_by_id": "9377d689-01fb-4abf-8450-3368d2c1924f"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Create OAuth app

Authorization

Cookie Parameters

Request Body

Response Body

201application/json

422application/json

`application/json`

`application/json`