---
title: "Invitation"
description: "a person invited by address to a role of the tenant, bound when they sign in with that address"
section: concepts
address: /concepts/invitation
contract: 0476e35e6e275db5
---

# Invitation

a person invited by address to a role of the tenant, bound when they sign in with that address

[figure: Invitation is a definition at tenant scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | definition |
| scope | tenant |
| key | the tenant and the address |
| store | postgres |
| family | people |



## Fields


| field | type | required | note |
|---|---|---|---|
| `tenant` | `id` | yes |  |
| `address` | `text` | yes |  |
| `role` | `text` | yes |  |
| `invited_by` | `id` | yes |  |
| `expires` | `time` | yes |  |
| `standing` | `one of open \| accepted \| expired \| withdrawn` | yes |  |
| `held_on` | [Scope](/concepts/scope) | no | the tenant, brand or strategy the role is held on once accepted; a guest's invitation names a brand |



## Routes that use it
- [`/v1/act/invite`](/reference/act/invite) returns it