Workflows / Stripe / customer.subscription.trial.will.end

Stripe Trial Ending Notification

Use the Stripe integration by MagicBell to setup a workflow when customer.subscription.trial.will.end triggers in Stripe.

Connect Stripe to MagicBell to receive events and trigger workflows. This guide uses the MagicBell CLI.

Add the Stripe integration

Save your Stripe webhook signing secret in MagicBell. See Stripe webhooks.

magicbell integration save_stripe \
  --data '{"webhook_signing_secret":"whsec_xxx"}'

Copy the ID from the response and use it to build your webhook URL:

https://api.magicbell.com/v2/integrations/stripe/webhooks/incoming/{id}

Setup the webhook

Setup a webhook in Stripe with the URL from the last step.
Select the customer.subscription.trial.will.end event.
If you already have a webhook configured, make sure it includes this event.

Add a workflow

Create a workflow that triggers automatically when Stripe sends this event.

Workflow key

Use this key to trigger the workflow when Stripe sends a customer.subscription.trial.will.end:

integration.stripe.customer.subscription.trial_will_end

Example workflow

Remind customers that their trial is ending soon and prompt them to add a payment method.

{
  "key": "integration.stripe.customer.subscription.trial_will_end",
  "steps": [
    {
      "command": "broadcast",
      "input": {
        "content": "Your free trial is ending in 3 days. Add a payment method to continue enjoying all features without interruption.",
        "recipients": [
          {
            "external_id": "{{payload.data.object.customer}}"
          }
        ],
        "title": "Your trial ends soon"
      }
    }
  ]
}

Save with the CLI

Use the MagicBell CLI to save this workflow to your project. You can also use the Workflows API endpoint instead.

magicbell workflow save \
  --data '{"key":"integration.stripe.customer.subscription.trial_will_end","steps":[{"command":"broadcast","input":{"content":"Your free trial is ending in 3 days. Add a payment method to continue enjoying all features without interruption.","recipients":[{"external_id":"{{payload.data.object.customer}}"}],"title":"Your trial ends soon"}}]}'

Event payload

Sample payload for the customer.subscription.trial.will.end event. Use liquid templates to access fields in your workflow.

{
  "api_version": "2023-10-16",
  "created": 1694109021,
  "data": {
    "object": {
      "cancel_at": null,
      "canceled_at": null,
      "collection_method": "charge_automatically",
      "created": 1679609767,
      "currency": "usd",
      "current_period_end": 1682288167,
      "current_period_start": 1679609767,
      "customer": "cus_Na6dX7aXxi11N4",
      "id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
      "items": {
        "data": [
          {
            "id": "si_Na6dzxczY5fwHx",
            "object": "subscription_item",
            "price": {
              "currency": "usd",
              "id": "price_1MowQULkdIwHu7ixraBm864M",
              "object": "price",
              "product": "prod_Na6dGcTsmU0I4R",
              "recurring": {
                "interval": "month",
                "interval_count": 1
              },
              "unit_amount": 1000
            },
            "quantity": 1,
            "subscription": "sub_1MowQVLkdIwHu7ixeRlqHVzs"
          }
        ],
        "object": "list"
      },
      "livemode": false,
      "object": "subscription",
      "start_date": 1679609767,
      "status": "trialing",
      "trial_end": 1680214567,
      "trial_start": 1679609767
    }
  },
  "id": "evt_1NqIZSLkdIwHu7ixJkU7Vx0x",
  "livemode": false,
  "object": "event",
  "type": "customer.subscription.trial_will_end"
}

View all Stripe workflows →