POST/entity

Create an account

Open an account (entity) that holds a balance inside a program.

Required Attributes

metadataobject

Arbitrary JSON

entity_namestringrequired

Name of the account

Example: "Treasury"

entity_typestringrequired

Your classification string

Example: "internal"

Request

POST/entity

curl --location 'https://api.ledgr.dev/v1/entity' \
--header 'Authorization: {api_key}' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {},
  "entity_name": "Treasury",
  "entity_type": "internal"
}'

Response

Account created

{
  "entity": {
    "status": "active",
    "entity_id": "ent_0274ef47",
    "entity_name": "Treasury",
    "entity_type": "internal",
    "currency_code": "USD"
  },
  "status": "success"
}