Skip to main content
Lovable now lets you integrate Cello user referrals entirely through chat. Just ask Lovable to “Add user referrals to your app” and it will do the rest - no manual coding required. Cello + Lovable integration

​
Prerequisites

Before integrating Cello, ensure the following prerequisites are met:
  • The project must be connected to Supabase. Learn more about Supabase
  • User signup and authentication via Supabase is functional
  • Stripe subscription flow is functional
  • You have a Cello account and API keys at hand.
Make sure to use Cello Sandbox environment when developing and testing

​
Connect the Cello MCP

The Cello MCP server gives Lovable direct access to Cello’s documentation, integration health checks, and best-practice recommendations. Connecting it before you start means Lovable can look up the right docs itself, verify your setup as it goes, and follow best practices automatically - instead of relying only on the guide link you paste. This step is optional but recommended. The integration steps below work either way. See Connect your client → Lovable for the setup steps.

​
Cello user referrals integration

For a step-by-step technical implementation (source of truth + acceptance criteria), follow the detailed guide:
1

Prep your project

  • Signup and authentication flow with Supabase is functional
  • Stripe subscription flow is functional
  • Cello API keys are handy
2

Add Cello Webhook Endpoint to Stripe

  • Get your webhook URL from Cello Portal
  • Add a Webhook endpoint in Stripe (Log into your Stripe Dashboard -> Go to Developer Mode -> Add a Webhook endpoint and enter endpoint URL -> Select the events to send -> Click “Add endpoint”)
  • Secure the Webhook with “Signing secret”
Events to send:
  • charge.refunded, charge.succeeded, charge.updated
  • customer.created, customer.deleted, customer.updated
  • customer.subscription.created, customer.subscription.deleted, customer.subscription.updated
  • invoice.paid
See Stripe Webhook Integration for more details.
3

Prompt Lovable to add User Referrals to your app

Switch Lovable to Plan mode, then paste this prompt:
I want to add user referrals to my app using Cello.

Use the Cello MCP to search the integration documentation, check my current integration status, and create a thorough implementation plan. Follow all best-practice recommendations from Cello.
Lovable will pull the relevant guides, check what’s already set up, and tailor the plan to your project.
Lovable asks you guiding questions and creates an implementation plan based on your answers.
4

Confirm executing the plan

Review the plan carefully. It should cover:
  • Cello JS SDK initialization and user authentication
  • Referral component placement and configuration
  • Attribution setup for tracking referred signups
  • Stripe webhook integration for conversion tracking
If it looks correct, tell Lovable to proceed and start implementing it.
5

Publish & Test

You cannot try the full end-to-end flow in Preview mode. Publish your changes to test.If everything was implemented correctly, you should see events coming in to Cello Dashboard.
If you have the Cello MCP connected, ask Lovable to run a health check after publishing:“Use Cello to check my integration status and confirm all four components are connected.”

​
After you’re live

If you have the Cello MCP connected, it continues to be useful after the initial integration:
PromptWhat happens
”Is my Cello integration working?”Checks all four integration components and reports which are connected or broken
”Why aren’t referral rewards being triggered?”Inspects recent events to find missing or malformed fields preventing attribution
”How can I improve my referral program?”Returns a prioritized list of recommendations across activation, sharing, and conversion
”How do I set up a custom referral launcher?”Searches the docs for custom launcher implementation guides