---
title: "Handle Revenuecat Events"
method: POST
path: "/webhook/revenuecat"
---

# Handle Revenuecat Events

`POST /webhook/revenuecat`

## Headers

- `authorization` string, nullable

## Request body

- RevenueCatWebhookPayload
  - `event` RevenueCatEvent, required
    - `product_id` string, required
    - `period_type` 'TRIAL' | 'INTRO' | 'NORMAL' | 'PROMOTIONAL' | 'PREPAID', required
    - `purchased_at_ms` integer, required
    - `expiration_at_ms` integer, nullable
    - `environment` 'PRODUCTION' | 'SANDBOX', required
    - `entitlement_ids` string[], nullable
    - `transaction_id` string, required
    - `is_family_share` boolean, required
    - `country_code` string, required
    - `app_user_id` string, required
    - `currency` string, required
    - `is_trial_conversion` boolean, nullable
    - `price` number, required
    - `price_in_purchased_currency` number, required
    - `store` 'AMAZON' | 'APP_STORE' | 'MAC_APP_STORE' | 'PADDLE' | 'PLAY_STORE' | 'PROMOTIONAL' | 'RC_BILLING' | 'ROKU' | 'STRIPE' | 'TEST_STORE', required
    - `takehome_percentage` number, required
    - `offer_code` string, nullable
    - `tax_percentage` number, required
    - `commission_percentage` number, required
    - `renewal_number` integer, nullable
    - `type` 'TEST' | 'INITIAL_PURCHASE' | 'NON_RENEWING_PURCHASE' | 'RENEWAL' | 'PRODUCT_CHANGE' | 'CANCELLATION' | 'BILLING_ISSUE' | 'SUBSCRIBER_ALIAS' | 'SUBSCRIPTION_PAUSED' | 'UNCANCELLATION' | 'TRANSFER' | 'SUBSCRIPTION_EXTENDED' | 'EXPIRATION' | 'TEMPORARY_ENTITLEMENT_GRANT' | 'INVOICE_ISSUANCE' | 'VIRTUAL_CURRENCY_TRANSACTION' | 'EXPERIMENT_ENROLLMENT', required
    - `cancel_reason` 'UNSUBSCRIBE' | 'BILLING_ERROR' | 'DEVELOPER_INITIATED' | 'PRICE_INCREASE' | 'CUSTOMER_SUPPORT' | 'UNKNOWN'
    - `expiration_reason` 'UNSUBSCRIBE' | 'BILLING_ERROR' | 'DEVELOPER_INITIATED' | 'PRICE_INCREASE' | 'CUSTOMER_SUPPORT' | 'UNKNOWN'
  - `api_version` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/revyze/apis/fastapi.md) · [All operations](https://skmtc.dev/revyze/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/revyze/fastapi/revisions/16168f916854/schema)