diff --git a/README.md b/README.md
index d80322d..d2a3b28 100644
--- a/README.md
+++ b/README.md
@@ -432,13 +432,17 @@ Options:
-b, --body
issue body (markdown)
--body-file read the issue body from a file
--assignee assign the issue to one or more users
+ --label apply one or more labels by name
```
```bash
-stoke issue create -o heavy-duty -r stoke -t "Ship v2" --body-file body.md
+stoke issue create -o heavy-duty -r stoke -t "Ship v2" --body-file body.md \
+ --label ready --label enhancement
```
-Calls `POST /api/v1/repos/{owner}/{repo}/issues`.
+Requested label names are resolved through the paginated repository label list,
+then their numeric IDs are included in `POST /api/v1/repos/{owner}/{repo}/issues`.
+An unknown label fails before the issue is created.
### `stoke issue show`