# Create a meeting link

`POST /meetinglink.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.json](https://developer.ro.am/chat.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. |

### 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.

### 401 - Presented invalid authentication credentials.

### 405 - An unsupported method was requested.

### 500 - An internal error occured.

---

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