---
title: "Create OAuth or domain connection"
method: POST
path: "/v1/account.createConnection"
tags: ["account"]
---

# Create OAuth or domain connection

`POST /v1/account.createConnection`

## Request body

- V1AccountCreateConnectionRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `code` string, required — The code from the oauth2 provider to verify
  - `provider` 'discord' | 'patreon' | 'kick' | 'reddit' | 'twitch' | 'youtube' | 'x' | 'domain', required — The provider to connect with
  - `redirectUri` string — The redirect_uri used to obtain the code. Must be an allowed frontend origin

## Response `200`

OK

- V1AccountCreateConnectionResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `code` string, required — Code that has to be used to verify domain connections
  - `connectionId` string, nullable — Public ID of the connection only for domain connections

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.net/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/versions/2e8ba266b27f/schema)