diff --git a/apps/sim/tools/revenuecat/delete_customer.ts b/apps/sim/tools/revenuecat/delete_customer.ts
index 2ff4e1468f..1c032d0f51 100644
--- a/apps/sim/tools/revenuecat/delete_customer.ts
+++ b/apps/sim/tools/revenuecat/delete_customer.ts
@@ -47,12 +47,7 @@ export const revenuecatDeleteCustomerTool: ToolConfig<
     return {
       success: true,
       output: {
-        deleted:
-          typeof body.deleted === 'boolean'
-            ? body.deleted
-            : typeof body.was_deleted === 'boolean'
-              ? body.was_deleted
-              : true,
+        deleted: typeof body.deleted === 'boolean' ? body.deleted : true,
         app_user_id:
           typeof body.app_user_id === 'string' ? body.app_user_id : (params?.appUserId ?? ''),
       },
diff --git a/apps/sim/tools/revenuecat/grant_entitlement.ts b/apps/sim/tools/revenuecat/grant_entitlement.ts
index e61d536363..016ce2d95f 100644
--- a/apps/sim/tools/revenuecat/grant_entitlement.ts
+++ b/apps/sim/tools/revenuecat/grant_entitlement.ts
@@ -40,7 +40,7 @@ export const revenuecatGrantEntitlementTool: ToolConfig<
       required: false,
       visibility: 'user-or-llm',
       description:
-        'Duration of the entitlement. Provide either duration or endTimeMs. One of: daily, three_day, weekly, two_week, monthly, two_month, three_month, six_month, yearly, lifetime',
+        'Deprecated. Duration of the entitlement. Provide either duration or endTimeMs (endTimeMs preferred). One of: daily, three_day, weekly, two_week, monthly, two_month, three_month, six_month, yearly, lifetime',
     },
     endTimeMs: {
       type: 'number',
@@ -54,7 +54,7 @@ export const revenuecatGrantEntitlementTool: ToolConfig<
       required: false,
       visibility: 'user-or-llm',
       description:
-        'Optional start time in milliseconds since Unix epoch. Set to a past time to achieve custom durations shorter than daily.',
+        'Deprecated. Optional start time in milliseconds since Unix epoch, used with duration to determine expiration. Regardless of value, the entitlement is always granted immediately.',
     },
   },
 
diff --git a/apps/sim/tools/revenuecat/list_offerings.ts b/apps/sim/tools/revenuecat/list_offerings.ts
index f2efd8fdbb..3b6e15c972 100644
--- a/apps/sim/tools/revenuecat/list_offerings.ts
+++ b/apps/sim/tools/revenuecat/list_offerings.ts
@@ -29,7 +29,8 @@ export const revenuecatListOfferingsTool: ToolConfig<ListOfferingsParams, ListOf
       type: 'string',
       required: false,
       visibility: 'user-or-llm',
-      description: 'Platform to filter offerings (ios, android, stripe, etc.)',
+      description:
+        'X-Platform header value. One of: ios, android, amazon, stripe, roku, paddle. Required when using a legacy public API key; ignored with app-specific API keys.',
     },
   },