---
title: "Connect a service — store its credential, resolve it registry-first (MCP directory row) or as a generic HTTP endpoint (origin allowlist + authenticated probe), optionally pin it onto nodes."
method: POST
path: "/services/connect"
tags: ["connections"]
---

# Connect a service — store its credential, resolve it registry-first (MCP directory row) or as a generic HTTP endpoint (origin allowlist + authenticated probe), optionally pin it onto nodes.

`POST /services/connect`

## Request

- Base URL: `https://api.livegraph.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.livegraph.ai/services/connect`
- Auth: one of:
  - API key in cookie `livegraph_session`
  - API key in header `x-api-key`

## Request body

- object
  - `service` string, required
  - `baseUrl` string, uri
  - `authStyle` 'bearer' | 'apikey' | 'basic' | 'query'
  - `headerName` string
  - `headerValuePrefix` string
  - `queryParam` string
  - `credentialName` string
  - `credentialValue` string
  - `pingPath` string
  - `pinTo` object[]
    - `graphId` string, uuid, required
    - `nodeId` string, uuid, required

## Response `200`

Success — see summary for the response shape.

## Other responses

- `4XX`: Client error — body is the shared {error, code?} envelope.

---

[API](https://skmtc.dev/livegraph/apis/livegraph-api.md) · [All operations](https://skmtc.dev/livegraph/apis/livegraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livegraph/apis/livegraph-api/revisions/551085d7719e?raw)