Upcoming Annual Renewals API Endpoint

1. 30 days before an annual subscription renews, you can use this API endpoint to notify Churn Buster of the upcoming invoice, and to trigger a branded email to be immediately sent to your customer.
2. You can preview your sandbox API requests in the debugger here if using your test-mode API key, or here if using your live-mode API key.

Emails will only be sent when using your live-mode API key, and this feature is only available to enterprise accounts who've requested access via the Churn Buster team.

curl -X "POST" "https://api.churnbuster.io/v1/upcoming_annual_renewals" \
    -H "Content-Type: application/json" \
    -u "ACCOUNT_ID:API_KEY" \
    -d $'{
  "invoice": {
    "source": "stripe",
    "source_id": "sub_abc123",
    "amount_in_cents": 4999,
    "currency": "USD",
    "renews_at": 1601586083
  },
  "customer": {
    "source": "stripe",
    "source_id": "cus_abc123",
    "email": "sarah@example.com",
    "properties": {
      "first_name": "Sarah",
      "last_name": "Doe"
    }
  }
}

A note about invoice.source_id:
It's possible the upcoming invoice doesn't yet have an ID assigned. In that case, you can use the Subscription ID as the invoice.source_id.

A note about source and source_id:
In most cases, you should use IDs from your payment processor. If you're using Stripe, source would be "stripe" and source_id would be "cus_sampleID".

If that's not possible, you can use IDs from your in-house billing system. source would be "in_house" and source_id would be "yourInternalId".

IDs should be unique to customers, subscriptions, invoices, payment methods, and payments.