Skip to main content
RevenueCat logo

Overview

Add RevenueCat to any ModuleX agent or workflow. Manage in-app subscriptions and entitlements against the RevenueCat REST API v1 (api.revenuecat.com/v1). Look up subscribers, grant or revoke promotional entitlements, record purchases, update subscriber attributes, and manage Google Play subscription billing.
Categories: Finance & Payments · Payments · Subscriptions · Auth: API Key · Actions: 10

Authentication

API Key Authentication

Authenticate using your RevenueCat REST API v1 key
1

Step 1

2

Step 2

Open Project Settings → API Keys
3

Step 3

Create or copy a secret API key (sk_…) for write operations
4

Step 4

Paste the API key below

Required Credentials

Available Actions

Parameters

string
required
The app user ID of the subscriber

Response

Parameters

string
required
The app user ID of the subscriber to delete

Response

Parameters

string
required
The app user ID of the subscriber
string
required
Store receipt or purchase token: iOS base64 receipt / JWSTransaction, Android purchase token, Amazon receipt, Stripe subscription or Checkout Session ID, Roku transaction ID, or Paddle subscription/transaction ID
string
required
Platform of the purchase, sent as the X-Platform header. One of: ios, android, amazon, macos, uikitformac, stripe, roku, paddle
string
Product identifier or SKU. Required for Google.
number
Price of the product. Required if you provide a currency.
string
ISO 4217 currency code. Required if you provide a price.
boolean
Deprecated. Triggers configured restore behavior for shared fetch tokens.
string
Identifier of the offering presented to the customer at purchase time.
string
Payment mode for the introductory period: pay_as_you_go, pay_up_front, or free_trial.
number
Introductory price paid (if any).
string
JSON object of subscriber attributes to set alongside the purchase. Each key maps to {“value”: string, “updated_at_ms”: number}.
integer
UNIX epoch ms used to resolve attribute conflicts at the request level.

Response

Parameters

string
required
The app user ID of the subscriber
string
required
The entitlement identifier to grant
string
Deprecated. Provide either duration or end_time_ms (end_time_ms preferred). One of: daily, three_day, weekly, two_week, monthly, two_month, three_month, six_month, yearly, lifetime.
integer
Absolute end time in ms since Unix epoch. Use instead of duration.
integer
Deprecated. Optional start time in ms since Unix epoch, used with duration.

Response

Parameters

string
required
The app user ID of the subscriber
string
required
The entitlement identifier to revoke

Response

Parameters

string
required
An app user ID to retrieve offerings for
string
X-Platform header value. One of: ios, android, amazon, stripe, roku, paddle. Required for legacy public API keys; ignored with app-specific keys.

Response

Parameters

string
required
The app user ID of the subscriber
string
required
JSON object of attributes to set. Each key maps to an object with “value” (string; null or empty deletes the attribute) and “updated_at_ms” (Unix epoch ms used for conflict resolution — required).

Response

Parameters

string
required
The app user ID of the subscriber
string
required
The Google Play product identifier of the subscription to defer
integer
Number of days to extend by (1-365). Provide extend_by_days or expiry_time_ms.
integer
Absolute new expiry time in ms since Unix epoch. Use instead of extend_by_days.

Response

Parameters

string
required
The app user ID of the subscriber
string
required
The store transaction identifier of the purchase to refund (e.g., GPA.3309-9122-6177-45730 for Google Play)

Response

Parameters

string
required
The app user ID of the subscriber
string
required
The Google Play product identifier of the subscription to revoke

Response

Limits & Quotas

  • Rate limits: RevenueCat applies per-endpoint rate limits; the 429 responses include a Retry-After header. Plan retries on the agent side.
  • Grant / revoke entitlement is for promotional entitlements only and requires a secret key.
  • Defer / refund / revoke Google subscription apply to Google Play purchases only. grant_entitlement and defer_google_subscription require exactly one of their two mutually-exclusive time parameters.
  • Error model: non-2xx responses and timeouts are caught and returned as success=False + error rather than raising. RevenueCat returns {code, message} on errors, which is surfaced in error.

Lemon Squeezy

Stripe

Square