---
title: "subscription.created webhook"
method: POST
path: "subscription.created"
tags: ["webhooks"]
---

# subscription.created webhook

`POST subscription.created` (webhook)

A new subscription was created

## Payload

- SubscriptionEvent
  - `activated_at` string, date-time, nullable
  - `billing_day_anchor` integer, required
  - `billing_start_date` string, date, nullable
  - `created_at` string, date-time, required
  - `currency` string, required
  - `customer_alias` string, nullable
  - `customer_id` string, MeteroidId, required
  - `customer_name` string, required
  - `end_date` string, date, nullable
  - `invoice_memo` string, nullable
  - `invoice_threshold` string, nullable
  - `mrr_cents` integer, required
  - `net_terms` integer, required
  - `period` 'MONTHLY' | 'QUARTERLY' | 'SEMIANNUAL' | 'ANNUAL', required
  - `plan_name` string, required
  - `start_date` string, date, required
  - `status` 'PENDING_ACTIVATION' | 'PENDING_CHARGE' | 'TRIAL_ACTIVE' | 'ACTIVE' | 'TRIAL_EXPIRED' | 'PAUSED' | 'SUSPENDED' | 'CANCELLED' | 'COMPLETED' | 'SUPERSEDED' | 'ERRORED', required
  - `subscription_id` string, MeteroidId, required
  - `trial_duration` integer, nullable
  - `version` integer, required
  - `id` string, MeteroidId, required
  - `timestamp` string, date-time, required
  - `type` 'metric.created' | 'customer.created' | 'subscription.created' | 'invoice.created' | 'invoice.finalized' | 'invoice.paid' | 'invoice.voided' | 'invoice.consolidated' | 'quote.accepted' | 'quote.converted' | 'credit_note.created' | 'credit_note.finalized' | 'credit_note.voided' | 'plan.created' | 'plan.published' | 'plan.archived' | 'product.created' | 'product.updated' | 'product.archived' | 'metric.updated' | 'metric.archived' | 'coupon.created' | 'coupon.updated' | 'coupon.archived' | 'addon.created' | 'addon.updated' | 'addon.archived', required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) · [All operations](https://skmtc.dev/meteroid-oss/apis/meteroid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/meteroid-oss/meteroid/revisions/03f9d8ae5c5e/schema)