> ## Documentation Index
> Fetch the complete documentation index at: https://docs.limejourney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entities

> Managing customer profiles in Lime Journey

Entities represent your customers or users in Lime Journey. Each entity can have custom properties, associated events, and segment memberships.

## Properties

Entities can have any number of custom properties:

```typescript theme={null}
{
  "external_id": "customer123",
  "properties": {
    "plan_type": "basic",
    "team_size": 5,
    "signup_date": "2024-01-15"
  }
}
```

## Creating Entities

```typescript SDK theme={null}
await client.createEntity({
  externalId: 'customer123',
  properties: {
    plan_type: 'basic',
    team_size: 5
  }
});
```

```bash HTTP theme={null}
curl -X POST https://api.limejourney.com/entities \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "customer123",
    "properties": {
      "plan_type": "basic",
      "team_size": 5
    }
  }'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.