diff --git a/README.md b/README.md
index fd1a9e6..b0e43d5 100644
--- a/README.md
+++ b/README.md
@@ -996,7 +996,7 @@ Key-value pairs for objects, tables for arrays.
 | 0 | Success (check `success` field – action may have returned an error like "person not found") |
 | 1 | General/unexpected error |
 | 2 | Missing or invalid tokens |
-| 3 | Subscription/plan required |
+| 3 | Subscription/plan required or free trial exhausted |
 | 4 | LinkedIn account issue |
 | 5 | Invalid arguments |
 | 6 | Rate limited |
@@ -1011,6 +1011,8 @@ Key-value pairs for objects, tables for arrays.
 - **URL normalization.** All LinkedIn URLs in responses are normalized to `https://www.linkedin.com/...` format without trailing slashes.
 - **Null fields.** Fields that are unavailable are returned as `null` or `[]`, not omitted.
 - **Action limits.** Configurable per-account action limits on the [platform](https://app.linkedapi.io) prevent LinkedIn policy violations. When a limit is reached, you get a `limitExceeded` error.
+- **Trial limits.** A `trialLimitReached` error exits with code 3. Subscribe or contact support
+  for a trial extension before retrying the workflow.
 
 See [Core Concepts](https://linkedapi.io/docs/core-concepts) for more details.
 
diff --git a/package-lock.json b/package-lock.json
index f72daa2..dd384cb 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,15 +1,15 @@
 {
   "name": "@linkedapi/linkedin-cli",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@linkedapi/linkedin-cli",
-      "version": "1.2.3",
+      "version": "1.2.4",
       "license": "MIT",
       "dependencies": {
-        "@linkedapi/node": "^2.3.2",
+        "@linkedapi/node": "^2.3.3",
         "@oclif/core": "^4.2.10"
       },
       "bin": {
@@ -2530,9 +2530,9 @@
       }
     },
     "node_modules/@linkedapi/node": {
-      "version": "2.3.2",
-      "resolved": "https://registry.npmjs.org/@linkedapi/node/-/node-2.3.2.tgz",
-      "integrity": "sha512-gFm3hykS5BytgivujjGrWS54vLPsQqKNUo4meo/JXrVRcTajYus+MInbn7zaYOdEkA8YAbc7qw1hZ40s9+o0KA==",
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/@linkedapi/node/-/node-2.3.3.tgz",
+      "integrity": "sha512-a5A+ErfzHceKS5oUbFNFErSzs66qGsI0gbAmHAqL+avWTJnjiD6ErCA4FSzF3GimmRzuGQOdp9SuG8zw3Obr0w==",
       "license": "MIT"
     },
     "node_modules/@nodable/entities": {
diff --git a/package.json b/package.json
index 17aa442..5f86a7b 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@linkedapi/linkedin-cli",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "AI-agent-friendly CLI for controlling LinkedIn accounts and retrieving real-time data.",
   "author": "Linked API",
   "license": "MIT",
@@ -43,7 +43,7 @@
     "ai-agent"
   ],
   "dependencies": {
-    "@linkedapi/node": "^2.3.2",
+    "@linkedapi/node": "^2.3.3",
     "@oclif/core": "^4.2.10"
   },
   "devDependencies": {
diff --git a/src/core/errors/error-handler.ts b/src/core/errors/error-handler.ts
index 25e9f5d..2012e48 100644
--- a/src/core/errors/error-handler.ts
+++ b/src/core/errors/error-handler.ts
@@ -33,6 +33,7 @@ export function mapLinkedApiErrorToCliError(error: LinkedApiError): TCliError {
       };
 
     case 'subscriptionRequired':
+    case 'trialLimitReached':
     case 'plusPlanRequired':
       return {
         exitCode: EXIT_CODE.SUBSCRIPTION,