Pull from Recharge

How to authenticate

Recharge uses API token authentication for secure access to your subscription data. For more information, check out the Recharge API Token documentation.

Generate your API token in Recharge

1. Log in to your Recharge merchant portal.
2. In the left navigation menu, select Tools & apps.
3. Click on API tokens.
4. Click Create an API token.
5. Fill in the required fields:
   
   • Name: Give your token a descriptive name (e.g., "Parabola Integration").
   • Contact email: Enter an email address for notifications about this token.
6. Set the permission scopes for your token:
   
   • Configure each resource with at least Read access (or Read and Write access if you plan to update data in the future).
   • Parabola typically only needs Read access to pull data for reporting and analysis.
7. Click Save to generate your token.
8. Copy your API token immediately and store it securely—you won't be able to view it again.

Note: Only store owners can create and view API tokens by default. Store owners can grant additional staff access to the API Tokens page if needed.

Connect in Parabola

1. In your Parabola flow, add a Pull from Recharge step.
2. Click Authorize in the step settings.
3. Paste your Recharge API token when prompted.

Parabola will securely store your credentials and use them to authenticate each request to Recharge.

Available data

Using the Recharge integration in Parabola, you can pull the following data from your subscription store:

• Customers: Customer records including names, email addresses, Shopify customer IDs, and account creation dates.
• Subscriptions: Active, cancelled, and expired subscriptions with billing frequency, next charge dates, order intervals, customer associations, and status information.
• Orders: Subscription orders with statuses (success, queued, error, cancelled), processing details, scheduled dates, and subscription linkages.
• Charges: Payment transactions including charge amounts, currencies, statuses (success, error, refunded, pending), and associated orders and subscriptions.
• Products: Product catalog data with titles, external product IDs (such as Shopify product IDs), and creation timestamps.
• Plans: Subscription plans and pricing details including billing intervals, plan names, and price points.
• Addresses: Customer shipping addresses with full location details, country information, and customer associations.
• Payment methods: Payment method records linked to customers, including payment types and creation dates.

Common use cases

• Track active, cancelled, and expired subscriptions to identify churn patterns, calculate retention rates, and flag at-risk subscribers for proactive intervention.
• Reconcile data from Charges, Orders, and Subscriptions to validate billing accuracy, track payment failures, and reconcile Recharge revenue with your accounting system or ERP.
• Pull Plans and Subscriptions data to compare performance across different billing intervals, pricing tiers, and product offerings—helping you optimize your subscription catalog.
• Identify charges with "error" or "pending" statuses and trigger automated workflows to notify customers, retry payments, or alert your customer success team.
• Pull Subscriptions with next charge dates to forecast upcoming revenue, plan inventory needs, and project cash flow for financial planning.

Tips for using Parabola with Recharge

• Set your Parabola flow to refresh daily or hourly to keep subscription metrics current. Use scheduled runs to monitor new subscriptions, track payment failures, or generate daily performance summaries.
• Use filters to focus on actionable data, such as subscriptions by status (active, cancelled, expired) or charges by status (error, pending), to isolate records that need immediate attention.
• Join related data for complete insights to see subscriber details or link charges with orders to validate payment processing.
• Add email or Slack alerts in Parabola to notify your team when payment failures spike, cancellation rates increase, or high-value subscriptions are cancelled.
• Join Recharge data with other systems, including Shopify orders, fulfillment data from your 3PL, or financial records from NetSuite to create end-to-end subscription lifecycle reports and reconciliations.
• Export cleaned and transformed Recharge data to a Visualization, Google Sheets, Airtable, or your data warehouse to power live dashboards and executive reporting.

By connecting Recharge with Parabola, you automate the manual work of pulling subscription data, building reports, and monitoring performance—freeing your team to focus on growing your subscriber base and improving retention.