---
title: "Create a community."
method: PUT
path: "/community"
tags: ["Community management"]
---

# Create a community.

`PUT /community`

## Request body

- CreateCommunityRequest — The data used to create a new community.
  - `shortName` string, required — The community's short name.
  - `fullName` string, required — The community's full name.
  - `description` string — The community's description.
  - `supportEmail` string — A support email address to receive community-specific notifications at.
  - `interactionNotifications` boolean — Whether to receive notifications for pending interactions by email at the support mailbox (see supportEmail).
  - `apiKey` string — The API key to set for the community. If this key is already assigned, a new one will be generated.
  - `domain` string — The API key identifying a domain that should be linked to the community.

## Response `200`

Community created.

- ApiKeyResponse — The API key that was assigned to the creation of a new element.
  - `apiKey` string, required — The API key value.

## Other responses

- `429` — Call rate limit threshold exceeded for this operation.
- `default` — The received request was invalid.

## Changes

- **2026-03-19** `7637660a4a6b` — 1 info
  - added the non-success response with the status `429`
- **2024-08-26** `47017afa7060` — 1 info
  - removed the non-success response with the status `400`
- **2024-08-23** `f0eaf8c12964` — 1 info
  - endpoint added
- **2022-06-27** `06f633c06bcd` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/changes/community/put.md)

---

[API](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api.md) · [All operations](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ec-jrc/interoperability-test-bed-rest-api/revisions/433b3c0ae6d4/schema)
