# Polar

```json
{
  "name": "Polar",
  "slug": "polar",
  "url": "https://composio.dev/toolkits/polar",
  "markdown_url": "https://composio.dev/toolkits/polar.md",
  "logo_url": "https://logos.composio.dev/api/polar",
  "categories": [
    "e-commerce",
    "finance & accounting"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-10-29T05:33:36.522Z"
}
```

![Polar logo](https://logos.composio.dev/api/polar)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Polar MCP or direct API to manage products, create checkouts, track subscriptions, and review orders through natural language.

## Summary

Polar is a merchant-of-record platform for digital products, payments, subscriptions, and customer management.
It simplifies global selling by handling checkout, billing, taxes, and customer portals.

## Categories

- e-commerce
- finance & accounting

## Toolkit Details

- Tools: 181

## Images

- Logo: https://logos.composio.dev/api/polar

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Polar.
  - Setup:
    - Configure Oauth2 credentials for Polar.
    - Use the credentials when creating an auth config in Composio.
- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Polar.
  - Setup:
    - Configure Api Key credentials for Polar.
    - Use the credentials when creating an auth config in Composio.
- **Bearer Token**
  - Type: `bearer_token`
  - Description: Bearer Token authentication for Polar.
  - Setup:
    - Configure Bearer Token credentials for Polar.
    - Use the credentials when creating an auth config in Composio.
- **No Auth**
  - Type: `custom`
  - Description: No Auth authentication for Polar.
  - Setup:
    - Configure No Auth credentials for Polar.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- List all products in my Polar account
- Review active Polar subscriptions this month
- Show recent Polar orders and customer details

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `POLAR_ACCEPT_DISPUTE` | Accept Dispute | Accept a dispute, permanently conceding the chargeback and settling it as lost. Organization Access Token permissions: `disputes:write`. |
| `POLAR_ACTIVATE_LICENSE_KEY` | Activate License Key | Activate a license key instance. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_ACTIVATE_LICENSE_KEY_PUBLIC` | Activate License Key | Activate a license key instance. This consumes an activation slot until the instance is deactivated. |
| `POLAR_ADD_PORTAL_MEMBER` | Add Portal Member | Add a customer portal member. Requires a member session with the owner or billing manager role; customer sessions are not accepted. Use a unique, controlled member identity and verify the returned member. |
| `POLAR_ADD_PORTAL_PAYMENT_METHOD` | Add Customer Payment Method | Add a payment method to the authenticated customer. |
| `POLAR_ASSIGN_CUSTOMER_SEAT` | Assign Seat | Assign a customer seat. By default this sends an invitation email; set immediate_claim to true to claim the seat without emailing. Verify the target before assigning access. |
| `POLAR_ASSIGN_PORTAL_SEAT` | Assign Portal Seat | Assign a seat using an authenticated customer or member session. By default this sends an invitation email; set immediate_claim to true to claim the seat without emailing. Verify the target before assigning access. |
| `POLAR_CANCEL_PORTAL_SUBSCRIPTION` | Cancel Subscription | Cancel a subscription of the authenticated customer. This changes its cancellation state and can end access according to the subscription terms. |
| `POLAR_CHECK_PORTAL_EMAIL_UPDATE` | Check Email Change Token | Check if an email change verification token is still valid. |
| `POLAR_CLAIM_CUSTOMER_SEAT` | Claim Seat | Claim a customer seat without authentication using a one-time invitation token. This consumes the token, allocates access, and returns a customer session token. |
| `POLAR_COMPLETE_FILE_UPLOAD` | Complete File Upload | Complete a file upload. Organization Access Token permissions: `files:write`. |
| `POLAR_CONFIRM_CHECKOUT_BY_CLIENT_SECRET` | Confirm Checkout Session from Client | Confirm a checkout session by client secret. This may trigger payment or finalize an existing transaction. |
| `POLAR_CONFIRM_PORTAL_PAYMENT_METHOD` | Confirm Customer Payment Method | Confirm a payment method for the authenticated customer. This may trigger payment or finalize an existing transaction. |
| `POLAR_CONFIRM_PORTAL_RETRY_PAYMENT` | Confirm Retry Payment | Confirm a retry payment using a Stripe confirmation token. This may trigger payment or finalize an existing transaction. |
| `POLAR_CREATE_BENEFIT` | Create Benefit | Create a benefit, for example license keys, file downloads or Discord access. Organization Access Token permissions: `benefits:write`. |
| `POLAR_CREATE_CHECKOUT` | Create Checkout Session | Create a checkout session. Organization Access Token permissions: `checkouts:write`. |
| `POLAR_CREATE_CHECKOUT_LINK` | Create Checkout Link | Create a checkout link. Organization Access Token permissions: `checkout_links:write`. |
| `POLAR_CREATE_CUSTOMER` | Create Customer | Create a customer. Organization Access Token permissions: `customers:write`. |
| `POLAR_CREATE_CUSTOMER_MEMBER` | Create Customer Member | Add a member to a customer by UUID. This grants customer access, so verify the identity and intended role first. Organization Access Token permissions: `members:write`. |
| `POLAR_CREATE_CUSTOMER_MEMBER_BY_EXTERNAL_ID` | Create Customer Member by External ID | Add a member to a uniquely identified external customer. This grants customer access, so verify the customer, identity, and intended role first. Organization Access Token permissions: `members:write`. |
| `POLAR_CREATE_CUSTOMER_SESSION` | Create Customer Session | Create a customer session. Organization Access Token permissions: `customer_sessions:write`. |
| `POLAR_CREATE_CUSTOM_FIELD` | Create Custom Field | Create an organization custom field for collecting structured customer or checkout data. |
| `POLAR_CREATE_DISCOUNT` | Create Discount | Create a discount. Organization Access Token permissions: `discounts:write`. |
| `POLAR_CREATE_FILE` | Create File | Create a file. Organization Access Token permissions: `files:write`. |
| `POLAR_CREATE_METER` | Create Meter | Create a meter. Organization Access Token permissions: `meters:write`. |
| `POLAR_CREATE_METRIC_DASHBOARD` | Create Metric Dashboard | Create a user-defined metric dashboard. Organization Access Token permissions: `metrics:write`. |
| `POLAR_CREATE_ORDER` | Create Order | Create a draft order for an off-session charge against a saved payment Organization Access Token permissions: `orders:write`. |
| `POLAR_CREATE_ORGANIZATION` | Create Organization | Create an organization. |
| `POLAR_CREATE_PRODUCT` | Create Product | Create a product. Organization Access Token permissions: `products:write`. |
| `POLAR_CREATE_REFUND` | Create Refund | Create a refund. Organization Access Token permissions: `refunds:write`. |
| `POLAR_CREATE_SUBSCRIPTION` | Create Subscription | Create a subscription programmatically. Organization Access Token permissions: `subscriptions:write`. |
| `POLAR_CREATE_WEBHOOK_ENDPOINT` | Create Webhook Endpoint | Create a webhook endpoint. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_DEACTIVATE_LICENSE_KEY` | Deactivate License Key | Deactivate a license key instance. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_DEACTIVATE_LICENSE_KEY_PUBLIC` | Deactivate License Key | Deactivate a license key instance. The identified installation immediately loses its activation. |
| `POLAR_DELETE_BENEFIT` | Delete Benefit | Delete a benefit. This also revokes every associated grant and removes user access. Organization Access Token permissions: `benefits:write`. |
| `POLAR_DELETE_CHECKOUT_LINK` | Delete Checkout Link | Delete a checkout link. Organization Access Token permissions: `checkout_links:write`. |
| `POLAR_DELETE_CUSTOMER` | Delete Customer | Delete a customer. Organization Access Token permissions: `customers:write`. |
| `POLAR_DELETE_CUSTOMER_BY_EXTERNAL_ID` | Delete Customer by External ID | Delete a customer by external ID. Organization Access Token permissions: `customers:write`. |
| `POLAR_DELETE_CUSTOMER_MEMBER` | Delete Customer Member | Permanently remove a member by customer UUID and member UUID. Use only for a disposable or explicitly confirmed member; never remove the sole owner or an unverified shared member. Organization Access Token permissions: `members:write`. |
| `POLAR_DELETE_CUSTOMER_MEMBER_BY_EXTERNAL_ID` | Delete Customer Member by External ID | Permanently remove a member by customer and member external IDs. Verify both targets and use only for a disposable or explicitly confirmed member; never remove the sole owner or an unverified shared member. Organization Access Token permissions: `members:write`. |
| `POLAR_DELETE_CUSTOM_FIELD` | Delete Custom Field | Permanently delete a custom field by ID. Verify the field before deletion. |
| `POLAR_DELETE_DISCOUNT` | Delete Discount | Delete a discount. Organization Access Token permissions: `discounts:write`. |
| `POLAR_DELETE_FILE` | Delete File | Delete a file. Organization Access Token permissions: `files:write`. |
| `POLAR_DELETE_METRIC_DASHBOARD` | Delete Metric Dashboard | Delete a user-defined metric dashboard. Organization Access Token permissions: `metrics:write`. |
| `POLAR_DELETE_PORTAL_PAYMENT_METHOD` | Delete Customer Payment Method | Delete a payment method from the authenticated customer. |
| `POLAR_DELETE_PRODUCT` | Delete Product | Delete a product. Organization Access Token permissions: `products:write`. |
| `POLAR_DELETE_WEBHOOK_ENDPOINT` | Delete Webhook Endpoint | Delete a webhook endpoint. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_EXPORT_CUSTOMERS` | Export Customers | Export customers as a CSV file. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_EXPORT_METRICS` | Export Metrics | Export metrics as a CSV file. Organization Access Token permissions: `metrics:read`. |
| `POLAR_EXPORT_ORDERS` | Export Orders | Export orders as a CSV file. Organization Access Token permissions: `orders:read`. |
| `POLAR_EXPORT_SUBSCRIPTIONS` | Export Subscriptions | Export subscriptions as a CSV file. Organization Access Token permissions: `subscriptions:read` or `subscriptions:write`. |
| `POLAR_FINALIZE_ORDER` | Finalize Order | Finalize a draft order and synchronously attempt an off-session charge. This may trigger payment or finalize an existing transaction. Organization Access Token permissions: `orders:write`. |
| `POLAR_GENERATE_ORDER_INVOICE` | Generate Order Invoice | Trigger generation of an order's invoice. Organization Access Token permissions: `orders:read`. |
| `POLAR_GENERATE_PORTAL_ORDER_INVOICE` | Generate Order Invoice | Trigger generation of an order's invoice. |
| `POLAR_GET_BENEFIT` | Get Benefit | Get a benefit by ID. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_GET_CHECKOUT` | Get Checkout Session | Get a checkout session by ID. Organization Access Token permissions: `checkouts:read` or `checkouts:write`. |
| `POLAR_GET_CHECKOUT_BY_CLIENT_SECRET` | Get Checkout Session from Client | Get a checkout session by client secret. |
| `POLAR_GET_CHECKOUT_LINK` | Get Checkout Link | Get a checkout link by ID. Organization Access Token permissions: `checkout_links:read` or `checkout_links:write`. |
| `POLAR_GET_CUSTOMER` | Get Customer | Get a customer by ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_GET_CUSTOMER_BY_EXTERNAL_ID` | Get Customer by External ID | Get a customer by external ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_GET_CUSTOMER_MEMBER` | Get Customer Member | Get a member by customer UUID and member UUID without changing membership. Organization Access Token permissions: `members:read` or `members:write`. |
| `POLAR_GET_CUSTOMER_MEMBER_BY_EXTERNAL_ID` | Get Customer Member by External ID | Get a member by customer and member external IDs without changing membership. The customer external ID must be unique across accessible organizations. Organization Access Token permissions: `members:read` or `members:write`. |
| `POLAR_GET_CUSTOMER_METER` | Get Customer Meter | Get a customer meter by ID. Organization Access Token permissions: `customer_meters:read`. |
| `POLAR_GET_CUSTOMER_SEAT_CLAIM_INFO` | Get Claim Info | Inspect a one-time customer-seat invitation before claiming it, including the customer and subscription context. |
| `POLAR_GET_CUSTOMER_STATE` | Get Customer State | Get a customer state by ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_GET_CUSTOMER_STATE_BY_EXTERNAL_ID` | Get Customer State by External ID | Get a customer state by external ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_GET_CUSTOM_FIELD` | Get Custom Field | Get one organization custom field and its validation settings by ID. |
| `POLAR_GET_DISCOUNT` | Get Discount | Get a discount by ID. Organization Access Token permissions: `discounts:read` or `discounts:write`. |
| `POLAR_GET_DISPUTE` | Get Dispute | Get a payment dispute by ID. Organization Access Token permissions: `disputes:read` or `disputes:write`. |
| `POLAR_GET_EVENT` | Get Event | Get an event by ID. Organization Access Token permissions: `events:read` or `events:write`. |
| `POLAR_GET_LICENSE_KEY` | Get License Key | Get a license key. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:read` or `license_keys:write`. |
| `POLAR_GET_LICENSE_KEY_ACTIVATION` | Get Activation | Get a license key activation. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:read` or `license_keys:write`. |
| `POLAR_GET_METER` | Get Meter | Get a meter by ID. Organization Access Token permissions: `meters:read` or `meters:write`. |
| `POLAR_GET_METER_QUANTITIES` | Get Meter Quantities | Get quantities of a meter over a time period. Organization Access Token permissions: `meters:read` or `meters:write`. |
| `POLAR_GET_METRIC_DASHBOARD` | Get Metric Dashboard | Get a user-defined metric dashboard by ID. Organization Access Token permissions: `metrics:read`. |
| `POLAR_GET_METRICS` | Get Metrics | Get metrics about your orders and subscriptions. Organization Access Token permissions: `metrics:read`. |
| `POLAR_GET_METRICS_LIMITS` | Get Metrics Limits | Get the interval limits for the metrics endpoint. Organization Access Token permissions: `metrics:read`. |
| `POLAR_GET_ORDER` | Get Order | Get an order by ID. Organization Access Token permissions: `orders:read`. |
| `POLAR_GET_ORDER_INVOICE` | Get Order Invoice | Get an order's invoice data. Organization Access Token permissions: `orders:read`. |
| `POLAR_GET_ORDER_RECEIPT` | Get Order Receipt | Get a presigned URL to download an order's receipt PDF. Organization Access Token permissions: `orders:read`. |
| `POLAR_GET_ORGANIZATION` | Get Organization | Get an organization by ID. Organization Access Token permissions: `organizations:read` or `organizations:write`. |
| `POLAR_GET_PAYMENT` | Get Payment | Get a payment by ID. Organization Access Token permissions: `payments:read`. |
| `POLAR_GET_PORTAL_BENEFIT_GRANT` | Get Benefit Grant | Get a benefit grant by ID for the authenticated customer. |
| `POLAR_GET_PORTAL_CUSTOMER` | Get Customer | Get authenticated customer. |
| `POLAR_GET_PORTAL_LICENSE_KEY` | Get License Key | Get a license key. |
| `POLAR_GET_PORTAL_METER` | Get Customer Meter | Get a meter by ID for the authenticated customer. |
| `POLAR_GET_PORTAL_ORDER` | Get Order | Get an order by ID for the authenticated customer. |
| `POLAR_GET_PORTAL_ORDER_INVOICE` | Get Order Invoice | Get an order's invoice data. |
| `POLAR_GET_PORTAL_ORDER_PAYMENT_STATUS` | Get Order Payment Status | Get the current payment status for an order. |
| `POLAR_GET_PORTAL_ORDER_RECEIPT` | Get Order Receipt | Get a presigned URL to download an order's receipt PDF. |
| `POLAR_GET_PORTAL_ORGANIZATION_PUBLIC` | Get Organization | Get a customer portal's organization by slug. |
| `POLAR_GET_PORTAL_SUBSCRIPTION` | Get Subscription | Get a subscription for the authenticated customer. |
| `POLAR_GET_PORTAL_USER` | Get Authenticated Portal User | Get information about the currently authenticated portal user. |
| `POLAR_GET_PORTAL_WALLET` | Get Portal Wallet | Get a wallet by ID using an authenticated customer or member session. |
| `POLAR_GET_PRODUCT` | Get Product | Get a product by ID. Organization Access Token permissions: `products:read` or `products:write`. |
| `POLAR_GET_SUBSCRIPTION` | Get Subscription | Get a subscription by ID. Organization Access Token permissions: `subscriptions:read` or `subscriptions:write`. |
| `POLAR_GET_WEBHOOK_ENDPOINT` | Get Webhook Endpoint | Get a webhook endpoint by ID. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `webhooks:read` or `webhooks:write`. |
| `POLAR_INGEST_EVENT` | Ingest Events | Ingest batch of events. Organization Access Token permissions: `events:write`. |
| `POLAR_INTROSPECT_PORTAL_SESSION` | Introspect Customer Session | Introspect the current session and return its information. |
| `POLAR_LIST_BENEFIT_FILES` | List Benefit Files | List the downloadable files for a benefit with their download statistics. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_LIST_BENEFIT_GRANTS_BY_BENEFIT` | List Benefit Grants | List benefit grants across all benefits accessible to the authenticated subject. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_LIST_BENEFIT_GRANTS_BY_BENEFIT` | List Benefit Grants | List the individual grants for a benefit. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_LIST_BENEFITS` | List Benefits | List benefits. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_LIST_CHECKOUT_LINKS` | List Checkout Links | List checkout links. Organization Access Token permissions: `checkout_links:read` or `checkout_links:write`. |
| `POLAR_LIST_CHECKOUTS` | List Checkout Sessions | List checkout sessions. Organization Access Token permissions: `checkouts:read` or `checkouts:write`. |
| `POLAR_LIST_CUSTOMER_MEMBERS` | List Customer Members | List members of a customer by UUID without changing membership. Organization Access Token permissions: `members:read` or `members:write`. |
| `POLAR_LIST_CUSTOMER_MEMBERS_BY_EXTERNAL_ID` | List Customer Members by External ID | List members of a uniquely identified external customer without changing membership. Organization Access Token permissions: `members:read` or `members:write`. |
| `POLAR_LIST_CUSTOMER_METERS` | List Customer Meters | List customer meters. Organization Access Token permissions: `customer_meters:read`. |
| `POLAR_LIST_CUSTOMER_PAYMENT_METHODS` | List Customer Payment Methods | Get saved payment methods of a customer. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_LIST_CUSTOMER_PAYMENT_METHODS_BY_EXTERNAL_ID` | List Customer Payment Methods by External ID | Get saved payment methods of a customer by external ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_LIST_CUSTOMERS` | List Customers | List customers. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_LIST_CUSTOMER_SEATS` | List Seats | List seats assigned from organization subscriptions, including invitation and claim state. |
| `POLAR_LIST_CUSTOM_FIELDS` | List Custom Fields | List custom data fields configured for an organization and their validation settings. |
| `POLAR_LIST_DISCOUNTS` | List Discounts | List discounts. Organization Access Token permissions: `discounts:read` or `discounts:write`. |
| `POLAR_LIST_DISPUTES` | List Disputes | List payment disputes. Organization Access Token permissions: `disputes:read` or `disputes:write`. |
| `POLAR_LIST_EVENT_NAMES` | List Event Names | List event names. Organization Access Token permissions: `events:read` or `events:write`. |
| `POLAR_LIST_EVENTS` | List Events | List events. Organization Access Token permissions: `events:read` or `events:write`. |
| `POLAR_LIST_EVENT_TYPES` | List Event Types | List event types with usage statistics. Organization Access Token permissions: `events:read` or `events:write`. |
| `POLAR_LIST_FILES` | List Files | List files. Organization Access Token permissions: `files:read` or `files:write`. |
| `POLAR_LIST_LICENSE_KEYS` | List License Keys | Get license keys connected to the given organization & filters. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:read` or `license_keys:write`. |
| `POLAR_LIST_METERS` | List Meters | List meters. Organization Access Token permissions: `meters:read` or `meters:write`. |
| `POLAR_LIST_METRIC_DASHBOARDS` | List Metric Dashboards | List user-defined metric dashboards. Organization Access Token permissions: `metrics:read`. |
| `POLAR_LIST_ORDERS` | List Orders | List orders. Organization Access Token permissions: `orders:read`. |
| `POLAR_LIST_ORGANIZATIONS` | List Organizations | List organizations. Organization Access Token permissions: `organizations:read` or `organizations:write`. |
| `POLAR_LIST_PAYMENTS` | List Payments | List payments. Organization Access Token permissions: `payments:read`. |
| `POLAR_LIST_BENEFIT_GRANTS_BY_BENEFIT` | List Benefit Grants | List benefits grants of the authenticated customer. |
| `POLAR_LIST_PORTAL_CLAIMED_SUBSCRIPTIONS` | List Portal Claimed Subscriptions | List subscriptions claimed through seats by the authenticated customer or member session. |
| `POLAR_LIST_PORTAL_DOWNLOADABLES` | List Downloadables | List files the authenticated customer can download through granted benefits, optionally filtered by benefit. |
| `POLAR_LIST_PORTAL_LICENSE_KEYS` | List License Keys | List license keys issued to the authenticated customer, with optional organization and benefit filters. |
| `POLAR_LIST_PORTAL_MEMBERS` | List Portal Members | List customer portal members. Requires a member session with the owner or billing manager role; customer sessions are not accepted. |
| `POLAR_LIST_PORTAL_METERS` | List Meters | List meters of the authenticated customer. |
| `POLAR_LIST_PORTAL_ORDERS` | List Orders | List orders of the authenticated customer. |
| `POLAR_LIST_PORTAL_PAYMENT_METHODS` | List Customer Payment Methods | Get saved payment methods of the authenticated customer. |
| `POLAR_LIST_PORTAL_SEATS` | List Portal Seats | List seats for a subscription or order available to the authenticated customer or member session. |
| `POLAR_LIST_PORTAL_SUBSCRIPTIONS` | List Subscriptions | List subscriptions of the authenticated customer. |
| `POLAR_LIST_PORTAL_WALLETS` | List Portal Wallets | List wallets available to the authenticated customer or member session. |
| `POLAR_LIST_PRODUCTS` | List Products | List products. Organization Access Token permissions: `products:read` or `products:write`. |
| `POLAR_LIST_REFUNDS` | List Refunds | List refunds. Organization Access Token permissions: `refunds:read` or `refunds:write`. |
| `POLAR_LIST_SUBSCRIPTIONS` | List Subscriptions | List subscriptions. Organization Access Token permissions: `subscriptions:read` or `subscriptions:write`. |
| `POLAR_LIST_WEBHOOK_DELIVERIES` | List Webhook Deliveries | List webhook deliveries. Organization Access Token permissions: `webhooks:read` or `webhooks:write`. |
| `POLAR_LIST_WEBHOOK_ENDPOINTS` | List Webhook Endpoints | List webhook endpoints. Organization Access Token permissions: `webhooks:read` or `webhooks:write`. |
| `POLAR_REDELIVER_WEBHOOK_EVENT` | Redeliver Webhook Event | Schedule the re-delivery of a webhook event. This triggers a new external webhook delivery attempt. This causes an external delivery attempt and must not be retried automatically. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_REMOVE_PORTAL_MEMBER` | Remove Portal Member | Permanently remove a customer portal member. Requires a member session with the owner or billing manager role; customer sessions are not accepted. Use only a disposable member; never target the sole owner or a shared production member. |
| `POLAR_REQUEST_PORTAL_EMAIL_UPDATE` | Request Email Change | Request an email change for the authenticated customer. This sends a verification message to the proposed address. |
| `POLAR_RESEND_CUSTOMER_SEAT_INVITATION` | Resend Invitation | Resend the invitation email for an unclaimed customer seat. This triggers an external email delivery and should not be retried automatically. |
| `POLAR_RESEND_PORTAL_SEAT_INVITATION` | Resend Portal Seat Invitation | Resend a pending seat invitation using an authenticated customer or member session. This sends another email; use a controlled deliverable address and avoid repeated calls. |
| `POLAR_RESET_WEBHOOK_SECRET` | Reset Webhook Endpoint Secret | Regenerate a webhook endpoint secret. The request or response contains sensitive credential material; never log or persist it. This irreversibly replaces the existing secret; update dependents immediately. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_REVOKE_CUSTOMER_SEAT` | Revoke Seat | Permanently revoke a customer seat by ID. Verify the seat before removing access. |
| `POLAR_REVOKE_PORTAL_SEAT` | Revoke Portal Seat | Permanently revoke a seat using an authenticated customer or member session. Use only a disposable seat; never target a sole owner or shared production resource. |
| `POLAR_REVOKE_SUBSCRIPTION` | Revoke Subscription | Revoke a subscription, i.e cancel immediately. This irreversibly revokes the subscription immediately. Organization Access Token permissions: `subscriptions:write`. |
| `POLAR_ROTATE_LICENSE_KEY` | Rotate License Key | Rotate a license key. The request or response contains sensitive credential material; never log or persist it. This irreversibly replaces the existing secret; update dependents immediately. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_ROTATE_PORTAL_LICENSE_KEY` | Rotate License Key | Rotate a license key. The existing key is invalidated and cannot be recovered. |
| `POLAR_UPDATE_BENEFIT` | Update Benefit | Update a benefit. Organization Access Token permissions: `benefits:write`. |
| `POLAR_UPDATE_CHECKOUT` | Update Checkout Session | Update a checkout session. Organization Access Token permissions: `checkouts:write`. |
| `POLAR_UPDATE_CHECKOUT_BY_CLIENT_SECRET` | Update Checkout Session from Client | Update a checkout session by client secret. |
| `POLAR_UPDATE_CHECKOUT_LINK` | Update Checkout Link | Update a checkout link. Organization Access Token permissions: `checkout_links:write`. |
| `POLAR_UPDATE_CUSTOMER` | Update Customer | Update a customer. Organization Access Token permissions: `customers:write`. |
| `POLAR_UPDATE_CUSTOMER_BY_EXTERNAL_ID` | Update Customer by External ID | Update a customer by external ID. Organization Access Token permissions: `customers:write`. |
| `POLAR_UPDATE_CUSTOMER_MEMBER` | Update Customer Member | Update a member by customer UUID and member UUID. Role changes can grant billing or ownership privileges, so verify the target and role first. Organization Access Token permissions: `members:write`. |
| `POLAR_UPDATE_CUSTOMER_MEMBER_BY_EXTERNAL_ID` | Update Customer Member by External ID | Update a member by customer and member external IDs. Role changes can grant billing or ownership privileges, so verify both targets and the role first. Organization Access Token permissions: `members:write`. |
| `POLAR_UPDATE_CUSTOM_FIELD` | Update Custom Field | Update an organization custom field's label, validation, or data-collection settings. |
| `POLAR_UPDATE_DISCOUNT` | Update Discount | Update a discount. Organization Access Token permissions: `discounts:write`. |
| `POLAR_UPDATE_EVENT_TYPE` | Update Event Type | Update an event type's label or dynamic label selector. Organization Access Token permissions: `events:write`. |
| `POLAR_UPDATE_FILE` | Update File | Update a file. Organization Access Token permissions: `files:write`. |
| `POLAR_UPDATE_LICENSE_KEY` | Update License Key | Update a license key. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_UPDATE_METER` | Update Meter | Update a meter. Organization Access Token permissions: `meters:write`. |
| `POLAR_UPDATE_METRIC_DASHBOARD` | Update Metric Dashboard | Update a user-defined metric dashboard. Organization Access Token permissions: `metrics:write`. |
| `POLAR_UPDATE_ORDER` | Update Order | Update an order. Organization Access Token permissions: `orders:write`. |
| `POLAR_UPDATE_ORGANIZATION` | Update Organization | Update an organization. Organization Access Token permissions: `organizations:write`. |
| `POLAR_UPDATE_PORTAL_BENEFIT_GRANT` | Update Benefit Grant | Update a benefit grant for the authenticated customer. |
| `POLAR_UPDATE_PORTAL_CUSTOMER` | Update Customer | Update authenticated customer. |
| `POLAR_UPDATE_PORTAL_MEMBER` | Update Portal Member | Update a customer portal member's name or role. Requires a member session with the owner or billing manager role; customer sessions are not accepted. Verify role changes against a disposable member. |
| `POLAR_UPDATE_PORTAL_ORDER` | Update Order | Update an order for the authenticated customer. |
| `POLAR_UPDATE_PORTAL_SUBSCRIPTION` | Update Subscription | Update a subscription of the authenticated customer. |
| `POLAR_UPDATE_PRODUCT` | Update Product | Update a product. Organization Access Token permissions: `products:write`. |
| `POLAR_UPDATE_PRODUCT_BENEFITS` | Update Product Benefits | Update benefits granted by a product. Organization Access Token permissions: `products:write`. |
| `POLAR_UPDATE_SUBSCRIPTION` | Update Subscription | Update a subscription. Organization Access Token permissions: `subscriptions:write`. |
| `POLAR_UPDATE_WEBHOOK_ENDPOINT` | Update Webhook Endpoint | Update a webhook endpoint. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_VALIDATE_LICENSE_KEY` | Validate License Key | Validate a license key and optionally increment its usage count. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_VALIDATE_LICENSE_KEY_PUBLIC` | Validate License Key | Validate a license key and optionally increment its usage count. |
| `POLAR_VERIFY_PORTAL_EMAIL_UPDATE` | Verify Email Change | Verify and apply an email change using the token from the verification email. This changes the customer's sign-in email. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to Polar
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["polar"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["polar"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run Polar tools with your agent

Send a request, execute the Polar tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "List all products in my Polar account"}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all products in my Polar account" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to Polar and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["polar"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["polar"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a Polar request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to Polar tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("List all products in my Polar account")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all products in my Polar account",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native Polar Integration

- Supports both Polar MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Polar data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Polar access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Polar
- Scoped, least privilege access to Polar resources
- Full audit trail of agent actions to support review and compliance

## Use Polar with any AI Agent Framework

Choose a framework you want to connect Polar with:

- [ChatGPT](https://composio.dev/toolkits/polar/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/polar/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/polar/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/polar/framework/atomic-agent)

## Related Toolkits

- [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.
- [44API](https://composio.dev/toolkits/44api) - 44API is an API service for validating VAT and tax identifiers and returning company details. Use it to verify business tax data and manage account IP whitelists quickly.
- [Addresszen](https://composio.dev/toolkits/addresszen) - Addresszen is a real-time address autocomplete and verification service. It helps capture accurate, deliverable addresses with instant suggestions and validation.
- [Airwallex](https://composio.dev/toolkits/airwallex) - Airwallex is a global financial platform providing business accounts, payments, payouts, FX, and cards. Built to simplify cross-border payments and streamline financial operations for businesses.
- [Aiwyn Tax MCP](https://composio.dev/toolkits/aiwyn_tax_mcp) - Aiwyn Tax MCP is a tax estimation service powered by Aiwyn's federal and state tax engine. It helps teams estimate tax outcomes without building tax calculation logic from scratch.
- [Alpaca](https://composio.dev/toolkits/alpaca) - Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.
- [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
- [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management.
- [Asin data api](https://composio.dev/toolkits/asin_data_api) - Asin data api gives you detailed, real-time product data from Amazon, including price, rank, and reviews. Perfect for e-commerce pros and data-driven marketers who need instant marketplace insights.
- [Baselinker](https://composio.dev/toolkits/baselinker) - BaseLinker is an all-in-one e-commerce management platform connecting stores, marketplaces, carriers, and more. It streamlines order processing, inventory control, and automates your sales operations.
- [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly.
- [Bestbuy](https://composio.dev/toolkits/bestbuy) - Best Buy is a leading retailer offering APIs for product, store, and recommendation data. Instantly access up-to-date retail insights for smarter shopping and decision-making.
- [bexio](https://composio.dev/toolkits/bexio) - bexio is a Swiss business management platform for accounting, invoicing, contacts, projects, banking, expenses, and payroll. It brings core business operations into one connected workspace.
- [Bigdata.com MCP](https://composio.dev/toolkits/bigdata_com_mcp) - Bigdata.com MCP provides grounded access to financial news, transcripts, filings, and entity intelligence. Ideal for building research workflows and generating timely market insights.
- [Billsby](https://composio.dev/toolkits/billsby) - Billsby is a subscription billing platform for managing customers, subscriptions, invoices, products, plans, usage counters, add-ons, and allowances. It helps SaaS and subscription teams automate billing operations without building complex billing logic from scratch.
- [Bluebarry](https://composio.dev/toolkits/bluebarry) - Bluebarry is a customer data and product-advice platform for shopper identities, profiles, and recommendations. It helps teams analyze customer context and synchronize shopper data for better commerce experiences.
- [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth.
- [Btcpay server](https://composio.dev/toolkits/btcpay_server) - BTCPay Server is a free, open-source, self-hosted Bitcoin payment processor. It lets merchants accept Bitcoin payments directly, cutting out middlemen and boosting privacy.
- [Cashfree](https://composio.dev/toolkits/cashfree_payments_mcp) - Cashfree is a merchant payments platform that handles collection, payouts, subscriptions, settlements, refunds, and identity verification. Simplifies merchant money lifecycle management with unified, API-driven workflows.
- [Cdr platform](https://composio.dev/toolkits/cdr_platform) - Cdr platform is an API for purchasing carbon dioxide removal services. It enables businesses to offset emissions by accessing verified carbon removal projects.

## Frequently Asked Questions

### Do I need my own developer credentials to use Polar with Composio?

Yes, Polar requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)