# The Member event object

> Attributes of a BloomText Member event and the endpoints that return it.

Source: https://www.bloomtext.com/developers/api/reference/member-event-object/

Who joined, was approved, or left an organization on your account, and who did it. Account API keys only.

### Attributes

- `type` (added, approved, removed, required): 

- `member_id` (UUID, required): 

- `org_id` (UUID, required): 

- `role` (string, required): 

- `occurred_at` (timestamp, required): 

- `actor_name` (string or null, required): Who made the change: a person's name, or `API key: <name>`.

### Endpoints

| Method | Path | Endpoint |
| --- | --- | --- |
| GET | `/member-events` | [List member events](https://www.bloomtext.com/developers/api/reference/list-member-events/) |

```json filename="The Member event object"
{
  "type": "added",
  "member_id": "8b9c2d2f-6b1a-44f4-a7b1-0d6d3f2d6f55",
  "org_id": "8b9c2d2f-6b1a-44f4-a7b1-0d6d3f2d6f55",
  "role": "string",
  "occurred_at": "2026-09-21T15:04:05Z",
  "actor_name": "API key: HR sync"
}
```