Skip to main content
WEBHOOK
subscription
{
  "id": "<string>",
  "type": "subscription.activated",
  "object": "event",
  "created": "2023-11-07T05:31:56Z",
  "data": {
    "subscriptionId": "<string>",
    "customerId": "<string>",
    "productId": "<string>",
    "priceId": "<string>",
    "priceSnapshotId": "<string>",
    "createTime": 1754819711382,
    "quantity": 1,
    "paymentMethodType": "CARD",
    "paymentInstrumentId": "<string>",
    "status": "incomplete",
    "billing": "charge_automatically",
    "merchantReference": "<string>",
    "trialStart": 1754819707000,
    "trialEnd": 1755078907000,
    "currentPeriodStart": 1754819706689,
    "currentPeriodEnd": 1755078906689,
    "cancelAt": 123,
    "cancelAtPeriodEnd": true,
    "canceledAt": 123,
    "cancelReason": "<string>",
    "currency": "USD",
    "recurringInvoiceItem": {
      "invoiceItemId": "<string>",
      "amount": 9.99,
      "currency": "USD",
      "description": "<string>",
      "periodStart": 1754819706689,
      "periodEnd": 1755078906689,
      "proration": true,
      "price": {
        "productId": "<string>",
        "productName": "<string>",
        "priceId": "<string>",
        "priceSnapshotId": "<string>",
        "unitAmount": 9.99,
        "quantity": 1,
        "recurring": {
          "interval": "week",
          "pricingModel": "flat_rate",
          "tiersMode": "volume",
          "trialPeriodDays": 123
        }
      }
    },
    "upcomingInvoiceItem": {
      "invoiceItemId": "<string>",
      "amount": 9.99,
      "currency": "USD",
      "description": "<string>",
      "periodStart": 1754819706689,
      "periodEnd": 1755078906689,
      "proration": true,
      "price": {
        "productId": "<string>",
        "productName": "<string>",
        "priceId": "<string>",
        "priceSnapshotId": "<string>",
        "unitAmount": 9.99,
        "quantity": 1,
        "recurring": {
          "interval": "week",
          "pricingModel": "flat_rate",
          "tiersMode": "volume",
          "trialPeriodDays": 123
        }
      }
    },
    "sessionId": "<string>",
    "metadata": {}
  }
}

Authorizations

​
X-API-KEY
string
header
required

Your secret API key obtained from the Clink dashboard (Developers section)

​
X-Timestamp
string
header
required

Current timestamp in milliseconds since Unix epoch (required for request signing)

Body

application/json

Subscription event payload in json

​
id
string

Unique identifier for the event

​
type
enum<string>

Type of event that occurred

Available options:
subscription.created,
subscription.trialing,
subscription.activated,
subscription.incomplete_expired,
subscription.past_due,
subscription.cancelled,
subscription.updated.plan_changed,
subscription.updated.plan_change_canceled,
subscription.updated.renewed,
subscription.updated.cancel_at_period_end_set,
subscription.updated.cancel_at_period_end_revoked
Example:

"subscription.activated"

​
object
string

Type of this json payload, 'event' if this is an event

Example:

"event"

​
created
string<date-time>

Timestamp when the event occurred

​
data
object

Subscription data object containing all subscription details

Response

200

Return a 200 status to indicate that the data was received successfully