> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hookmyapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Publish a reel

> Publish a reel to the Page. HookMyApp runs the upload session for you.

Publishes a reel from a public https URL. Meta's reel upload is a three-step session (start, upload, finish); this route runs all three and returns the post id.

## Authentication

Use an `hmok_` API key and the workspace header, like every channel route. Requires a workspace admin.

```bash theme={null}
Authorization: Bearer hmok_...
X-Workspace-Id: ws_...
```

## Path parameters

<ParamField path="channelId" type="string" required>
  The Facebook channel id (`ch_xxxxxxxx`).
</ParamField>

## Request body

<ParamField body="videoUrl" type="string" required>
  Public https URL of an MP4.
</ParamField>

<ParamField body="description" type="string">
  Caption shown with the reel.
</ParamField>

## Example

```bash theme={null}
curl -X POST "https://api.hookmyapp.com/channels/ch_xxxxxxxx/facebook/reels" \
  -H "Authorization: Bearer hmok_..." \
  -H "X-Workspace-Id: ws_..." \
  -H "Content-Type: application/json" \
  -d '{ "videoUrl": "https://example.com/clip.mp4", "description": "Behind the scenes" }'
```

## Successful response

```json theme={null}
{ "channelId": "ch_xxxxxxxx", "postId": "100000000000001_500000000000003", "kind": "reel" }
```

## Errors

| Status | `code`                   | Meaning                                                                              |
| ------ | ------------------------ | ------------------------------------------------------------------------------------ |
| `404`  | `CHANNEL_NOT_FOUND`      | No such channel in this workspace.                                                   |
| `400`  | `MCP_FB_NOT_FACEBOOK`    | The channel is not a Facebook Page.                                                  |
| `403`  | `FACEBOOK_SCOPE_MISSING` | The Page was connected without publishing access. Reconnect the Page to enable this. |