Skip to content

RevenueCat

If your app sells subscriptions through RevenueCat, connect it, and Yoohoo tells you about new subscribers, failed renewals and refunds.

  1. In the app, open Add a source, then For developers, and pick RevenueCat.
  2. In RevenueCat, open API Keys, then New secret API key.
  3. Name it Yoohoo and pick API version 2.
  4. Under Project configuration permissions, set Projects Configuration to Read only and Integrations Configuration to Read & write. Leave the rest off, then click Generate.
  5. Paste the key into Yoohoo and tap Connect.

Yoohoo uses the key once to add a webhook to your RevenueCat project, then forgets it. The webhook only sends production purchases, from every app in the project.

If your key can’t read its project, Yoohoo asks for the project ID. It’s the letters and numbers after /projects/ in RevenueCat’s address.

If you’d rather not paste a key, tap Set it up by hand instead on the source:

  1. In RevenueCat, open Project settings, then Integrations, then Webhooks, and add a webhook with the link Yoohoo shows. Set the environment to Production.
  2. Set its Authorization header value to a long random value of your own, at least 20 characters. A new password from your password manager works.
  3. If RevenueCat asks which events to send, pick the ones Yoohoo lists.
  4. Paste the same authorization value into Yoohoo and tap Save value.

To check it works, use Send test event on the webhook in RevenueCat. A “Test event from RevenueCat” alert shows up in Yoohoo.

Event What happens
A new paid subscriber Interrupts you right away
A free trial turns into a paid subscription Interrupts you right away
A one-time purchase Interrupts you right away
A renewal payment fails Interrupts you right away
A refund Interrupts you right away
A free trial starts Waits for the roundup
A subscription renews Waits for the roundup
A subscriber cancels, comes back, changes plan or pauses Waits for the roundup
A subscription ends Waits for the roundup

Each alert shows the product, the store, the amount and the customer’s app user ID, and links to that customer in RevenueCat. Yoohoo leaves out sandbox purchases, such as those from TestFlight builds. When a renewal goes through after a failed one, Yoohoo marks the failure settled.

Two switches on the Rules screen change this. Turn off I make a sale to get new subscribers and purchases in the roundup instead. Turn off A payment fails or is refunded to do the same for failed renewals and refunds.

Delete the source in Yoohoo, and delete its webhook in RevenueCat too (Project settings, Integrations, Webhooks). Yoohoo’s webhook is named Yoohoo followed by a short code.