Lifecycle Reminders

Lifecycle Reminders are automated, time-based signals, that help you identify when users are stuck in critical steps of the subscription activation process. Gigs handles the monitoring and sends you webhook notifications when users need a nudge.

When to Use Lifecycle Reminders

With lifecycle reminders, you can:

• Send custom notifications (email, SMS, push notifications) to your users
• Trigger in-app prompts or onboarding guides

How They Work

Lifecycle Reminders are derived signals, not raw events. Gigs monitors the state of subscriptions, portings, and eSIM profiles, and fires reminder webhooks at specific time thresholds when a blocking condition persists. Once the condition is cleared (e.g., the eSIM gets installed), all future reminders are automatically cancelled.

All reminders have a type starting with a com.gigs.reminder. prefix. Below are the four types of lifecycle reminders available:

All reminders share the same payload schema with two fields in the data object:

{
  "type": "com.gigs.reminder.porting.informationRequired",
  "data": {
    "subscription": "sub_abc123xyz",
    "conditionTriggeredAt": "2025-01-21T19:38:34Z"
  }
}

The conditionTriggeredAt field indicates when the condition that triggered the reminder first occurred (e.g., when porting status changed to informationRequired or when the eSIM was assigned), helping you understand how long the condition has persisted.

To receive lifecycle reminders, you need to:

1. Navigate to the developers section of the Gigs dashboard
2. Click "Manage Webhooks" to open the Svix webhook dashboard
3. Subscribe to the reminders you want to receive, or use com.gigs.reminder.* to subscribe to all reminders

Once configured, you'll start receiving reminder notifications when users are stuck in the activation funnel.

Testing

To test lifecycle reminders in your development environment, see the testing guide.