---
title: "Create entity governance address"
method: POST
path: "/v3/entities/{id}/addresses"
tags: ["Entities"]
---

# Create entity governance address

`POST /v3/entities/{id}/addresses`

Creates a platform-verified, chain-scoped governance address for a KYBed entity. Because these addresses are ownership evidence for vault claims, writes require a platform-admin session and the corresponding CSRF token.

## Path parameters

- `id` string, required

## Request body

- EntityAddressCreateRequest
  - `chainId` integer, required
  - `address` string, required — Valid EVM address. Lowercase or correctly checksummed mixed-case input is accepted.
  - `label` string, nullable — Optional human-readable governance address label.

## Response `201`

Entity governance address was created.

- object
  - `data` EntityAddress, required
    - `entityId` string, required
    - `chainId` integer, required
    - `address` string, required — EIP-55 checksummed governance address in API responses.
    - `label` string, nullable, required — Optional human-readable governance address label.
  - `meta` PaginationMeta, required
    - `total` integer — Exact total count when the endpoint provides one.
    - `hasMore` boolean — Indicates whether another page exists beyond the current page.
    - `offset` integer
    - `limit` integer — Echoed page size after endpoint-side clamping.
    - `timestamp` string, date-time, required
    - `chainId` string — Comma-separated chain IDs for multi-chain responses.
    - `degradedProviders` string[] — Live providers whose data is incomplete in this response.

## Other responses

- `400` — Malformed JSON request body.
- `401` — Missing, invalid, or expired authenticated session.
- `403` — Platform-admin access is denied or the CSRF token is missing or mismatched.
- `404` — Entity profile was not found or chain is unsupported.
- `409` — Entity governance address already exists for the entity and chain.
- `422` — Missing or invalid address field.

---

[API](https://skmtc.dev/euler/apis/euler-data-api-v3.md) · [All operations](https://skmtc.dev/euler/apis/euler-data-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/euler/euler-data-api-v3/revisions/9573a5fbd4a6/schema)