Subscription Created

Fired when a new subscription is created, and a customer has successfully subscribed.

object

Identify this event with the HTTP POST parameter alert_name with a value of subscription_created

alert_name
string
1 validation
alert_id
string

The unique identifier for this Paddle webhook alert. Integer value sent as a string.

1 validation
cancel_url
string

A URL of the ‘Cancellation’ page. See the documentation for update / cancellation URLs. You should store this URL along with the subscribed customer in your database.

2 validations
checkout_id
string

The checkout id of the order created.

1 validation
currency
string

The three-letter ISO currency code. Eg: USD, GBP. See Supported Currencies.

1 validation
email
string

The email address of the customer.

1 validation
event_time
string

The date and time the event was triggered in UTC (Coordinated Universal Time).

2 validations
marketing_consent
string

The value of this field 1 or 0 indicates whether the user has agreed to receive marketing messages from the vendor.

1 validation
next_bill_date
string

The date the next payment is due on this subscription.

2 validations
passthrough
string

This field contains any values that you passed into the checkout using the passthrough parameter. See the Pass Parameters documentation for more information.

1 validation
quantity
string

The number of products or subscription seats sold in the transaction.

1 validation
source
string

Referrer website URL(s) from where the traffic originated from.

status
string

This is the current status of the subscription. A list of possible values and their meanings can be found under Event Statuses.

1 validation
subscription_id
string

This is the unique Subscription ID for this customer’s subscription. You should store this with the customer in your database, as it is needed for making API calls.

1 validation
subscription_plan_id
string

The ID of the Subscription Plan the customer is subscribed to. (This is the value that will change upon plan change).

1 validation
unit_price
string

The price per unit of the subscription.

1 validation
user_id
string

The customer user id.

1 validation
update_url
string

A URL of the ‘Update Billing Information’ page. See the documentation for update / cancellation URLs. You should store this URL along with the subscribed customer in your database.

2 validations
p_signature
string

This field contains an encrypted token that you can use to verify the request authenticity. See Verifying Webhooks.