---
title: "Add System Account to a Team"
method: POST
path: "/v3/teams/{teamId}/system-accounts"
tags: ["System Accounts - Team Membership"]
---

# Add System Account to a Team

`POST /v3/teams/{teamId}/system-accounts`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v3/teams/{teamId}/system-accounts`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Adds a system account to a team. Returns a 409 if the system account is already a member of the team.

## Request body

- object
  - `id` string, uuid: ID of the system account.

## Response `201`

Created

## Other responses

- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found
- `409`: Conflict

## Changes

- **2026-09-25** `68d43091b84d`: 3 warning
  - added the new `401.00` enum value to the `status` response property for the response status `401`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
  - added the new `409.00` enum value to the `status` response property for the response status `409`
- **2026-09-18** `f324fb7610e4`: 3 breaking, 23 info
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `404`
  - the response's body type changed from no type to `object` for status `409`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - …22 more
- **2025-08-22** `3c0154b2053a`: 5 breaking
  - the request's body became not nullable
  - the response property `detail` became nullable for the status `403`
  - the response property `instance` became nullable for the status `403`
  - the response property `status` became nullable for the status `403`
  - …1 more
- **2025-08-14** `6333a0d3b095`: 1 info
  - the request's body became nullable
- **2025-07-22** `76b0fefddb0d`: 1 breaking
  - the request's body became not nullable

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/teams/:teamId/system-accounts/post.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)