# Create a meeting link

`POST /meeting.link.create`

## Description

Create a meeting link.

**Access:** Organization and Personal. In Organization mode, specify the host by email. In Personal mode, the host defaults to the authenticated user.

**Required scope:** `meeting:write` or `meetinglink:write`

---

**OpenAPI Spec:** [chat-v1.json](https://developer.ro.am/chat-v1.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | string | Yes | Meeting Name |
| `host` | string | No | Meeting Host Email, matching a member of your Roam.  Required for Organization tokens. For Personal tokens, this is optional and defaults to the authenticated user. If provided with a Personal token,  |
| `start` | string | No | (Optional) Meeting start time in RFC3339. |
| `end` | string | No | (Optional) Meeting end time in RFC3339. |
| `requireUnconfirmedEmail` | boolean | No | (Optional) If true, guests must verify ownership of their email address before joining.  |

### Example Request

```json
{
  "name": "Q1 Planning Session",
  "host": "alex.chen@example.com",
  "start": "2026-02-15T14:00:00Z",
  "end": "2026-02-15T15:00:00Z"
}
```

## Responses

### 200 - Meeting link successfully created

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | No | Meeting link ID |
| `url` | string | No | Meeting link URL |


#### Example Response

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "url": "https://ro.am/r/#/d/abc123xyz/def456uvw"
}
```

### 400 - Bad request. Common causes:
- Required `name` missing
- Personal token provided a `host` that does not match the authenticated user
- Floor could not be determined for the meeting link (host has no home floor and the Roam has no default home floor configured)


### 401 - Presented invalid authentication credentials.

### 405 - An unsupported method was requested.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/api/meeting-link-create*