---
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`

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

- **2025-08-22** `96118a9cd7f4` — 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-03-05** `ceb048468954` — 1 info
  - the request's body became nullable

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

---

[API](https://skmtc.dev/kong/apis/konnect-api.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api/revisions/72502a676a92/schema)