---
title: "Connect a provider that authenticates with a login"
method: POST
path: "/connections/{provider}/credentials"
tags: ["Setup · Connections"]
---

# Connect a provider that authenticates with a login

`POST /connections/{provider}/credentials`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/connections/{provider}/credentials`
- Auth: HTTP bearer

## Path parameters

- `provider` string, required

## Request body

- StoreCredentialConnectionDto
  - `username` string, required: Portal login id. Stored encrypted.
  - `password` string, required: Portal password. Stored encrypted, never returned.

## Response `201`

Created

- ConnectionCreatedResponseSchema
  - `connection` ConnectionViewSchema, required
    - `connectionId` string, required
    - `ownerId` string, required
    - `provider` string, required
    - `externalAccountLabel` string, nullable
    - `externalAccountId` string, nullable
    - `scopesGranted` string[]
    - `mcpServerUrl` string, nullable: Remote MCP server URL for `provider: "mcp"` connections.
    - `status` string, required
    - `createdAt` string, date-time

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)