# 12.8 lpsd.group.member.added

_Peios / Using Peios / Events / Local Principal Events_

> The record that an administrator added an account to a group with lps, or tried to.

- **Event type:** `lpsd.group.member.added`
- **Defined in:** `lpsd.evman`
- **Tier:** essential
- **Gating:** none — every request to add a membership is recorded; one that already held is not
- **Cardinality:** once per request that changes something or fails

The record that an administrator added an account to a group with `lps`,
or tried to. The group may be a well-known one: adding an account to
`BUILTIN\Administrators` is recorded here.

Essential because a membership is a grant of everything granted to the
group, and memberships change rarely.

## 12.8.1 Fields

| Field | Type | Presence | Meaning |
|---|---|---|---|
| [`subject.token.sid`](/peios/using-peios/events/field-index/fields-subject.md#subject.token.sid) | `bin.sid` | required | The administrator. |
| [`object.account.sid`](/peios/using-peios/events/field-index/fields-object.md#object.account.sid) | `bin.sid` | optional | The account. Absent when no account had the name asked for. |
| [`object.group.sid`](/peios/using-peios/events/field-index/fields-object.md#object.group.sid) | `bin.sid` | optional | The group. Absent when no group had the name asked for. |
| [`outcome.success`](/peios/using-peios/events/field-index/fields-outcome.md#outcome.success) | `bool` | required | Whether the operation succeeded. |
| [`outcome.reason`](/peios/using-peios/events/field-index/fields-outcome.md#outcome.reason) | `str.enum` | when `outcome.success == false` | Why the operation resolved the way it did.<br><br>Values here (open set): `not-found` · `invalid` · `internal` · `not-saved`. |

Every record also carries the header fields of [the envelope](/peios/using-peios/events/introduction/the-envelope.md), which no payload repeats.

*Generated from `lpsd.evman` by `pkm/tools/gen-events-book.py`. Edit the fragment, not this page.*