---
title: "Assign a house to an energy community"
method: POST
path: "/energy-communities/{energyCommunityId}/houses"
tags: ["Energy communities"]
---

# Assign a house to an energy community

`POST /energy-communities/{energyCommunityId}/houses`

## Request

- Base URL: `https://connect.clever.gy`
- URL: `https://connect.clever.gy/energy-communities/{energyCommunityId}/houses`
- Auth: API key in header `clevergy-api-key`

Assign a house to an energy community

## Path parameters

- `energyCommunityId` string, required

## Request body

- EnergyCommunityHouse: Assign a house to an energy community
  - `houseId` string, required: House Id
  - `share` number, required: Share (in percentage) in the energy community
  - `installationId` string: Installation Id

## Response `201`

House successfully assigned

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Resource not found
- `default`: Unexpected error

---

[API](https://skmtc.dev/clevergy/apis/clevergy-connect-api.md) - [All operations](https://skmtc.dev/clevergy/apis/clevergy-connect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clevergy/apis/clevergy-connect-api/revisions/d333c5eecb5b?raw)