# List invite merge fields

Source: https://api-docs.magicdoor.com/api-reference/tenant-portal-invite-templates/list-invite-merge-fields

Returns the placeholder tokens that can be written into an invite template and the label to show for each. The same fixed list comes back for every company. Requires the `settings:read` permission.

`GET https://services.magicdoor.com/settings/company-portal/settings/tenant-portal-invite-templates/merge-fields`

**Authentication:** bearer token in the `Authorization` header, as `Bearer <token>`.

## Example request

```bash
curl --request GET \
  --url 'https://services.magicdoor.com/settings/company-portal/settings/tenant-portal-invite-templates/merge-fields' \
  --header 'Authorization: Bearer <token>'
```

## Responses

### 200 — The available merge fields.

- `token` (string, required) — The token to write into a template, without the braces.
- `label` (string, required) — A human-readable name for the token.

```json
[
  {
    "token": "TenantName",
    "label": "Tenant name"
  },
  {
    "token": "TenantPhone",
    "label": "Tenant phone"
  },
  {
    "token": "CompanyName",
    "label": "Company name"
  },
  {
    "token": "CompanyPhone",
    "label": "Company phone"
  },
  {
    "token": "CompanyEmail",
    "label": "Company email"
  },
  {
    "token": "PortalLink",
    "label": "Portal link"
  },
  {
    "token": "UserEmail",
    "label": "Login email"
  },
  {
    "token": "TempPassword",
    "label": "Temporary password"
  }
]
```

### 401 — The access token is missing, expired, or invalid.

### 403 — The caller does not hold the `settings:read` permission.

Write a token into an email subject, email body or text body wrapped in single braces — `{TenantName}` — and MagicDoor substitutes the tenant's own value when the message is sent.