Image Description Image Description

No Results

  • Support
Logo Logo v1.0
  • Basics
  • Getting started
  • Get authenticating user
  • Products
  • Create a Product
  • License Keys
  • Verify a License Key
  • Redeem a License Key
  • Refund a License Key
  • Subscriptions
  • Verify a Subscription
  • Webhooks
  • Basics
  • Subscribe
  • Unsubscribe
  • Webhook Events
  • New sale
  • New lead
  • New affiliate sign-up
  • New subscription
  • Subscription cancellation

Webhook - New Subscription Event

You may use webhook integrations to be notified in real-time of certain events that happen in your Zylvie store.

You specify your webhook URLs under Workflows > Add Workflow.

The "new subscription" event is when a buyer subscribes to a subscription product (this includes new subscriptions with free trials).

Example event payload

  
    {
    "event": "subscription",
    "data": {
        "subscription_id": "sub_1OoXxPF18w81dttLN6XyvuBl",
        "created_at": "2025-02-27T21:12:59Z",
        "ip": "10.42.1.190",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
        "cancel_at": null,
        "canceled_at": null,
        "trial_end": "2025-03-22T21:12:59Z",
        "trial_start": "2025-02-27T21:12:59Z",
        "currency": "usd",
        "amount": 99.99,
        "interval": "month",
        "interval_count": 1,
        "stripe_price_id": "price_1OkfZsF18w81dttL2OgdOtEj",
        "status": "active",
        "product": {
            "id": "R54wJ68y",
            "title": "Life Coaching (Pro Tier)",
            "pricing_model": "subscription",
            "is_variant": false,
            "tags": [
                "tag1",
                "tag2",
                "tag3"
            ]
        },
        "buyer": {
            "name": "Stavros Flatley",
            "email": "stavros@greek.com",
            "permission_to_send_emails": true,
            "phone": "+353850163326",
            "line1": "349 Navan Road",
            "line2": "Ashtown",
            "postal_code": "D07 R2C3",
            "city": "Dublin 7",
            "state": "County Dublin",
            "country": "IE",
            "payment_method_type": "card",
            "card_brand": "visa",
            "card_last4": "0005"
        },
        "coupon": {
            "code": "20OFF",
            "type": "percentage",
            "amount": 20.0
        },
        "referrer": {
            "email": "john.cena@zlappo.com"
        },
        "custom_fields": [
            {
                "name": "Tax identification number",
                "value": "TIN-5252445767"
            }
        ],
        "commission_earned": 41.99,
        "commission_paid": false
    }
}