subscription.updated

페이로드

객체: EventSubscriptionUpdated

• idstring필수

  이벤트 ID(evt_…)로, webhook-id 헤더로도 보내요. 중복 전송을 걸러 내는 데 쓰세요.

• typestring필수

  허용 값: subscription.updated

• created_atstring (date-time)필수

  변경이 일어난 시각(UTC).

• org_idinteger필수
• api_versionstring필수

  data 스키마의 계약 버전.

• sequenceinteger

  웹훅 안에서의 전송 순번(테스트 이벤트에는 없어요).

• objectWebhookEventObject필수
• payloadstring필수

  thin은 data 필드가 없다는 뜻이에요: API로 객체를 읽으세요.

  허용 값: fullthin

• dataobject
  필드

  • subscriptionEventSubscription필수
  • previous_attributesobject필수

    객체에서 변경된 최상위 필드의 이전 값.

  • actor_idinteger | null필수

    해당 동작을 수행한 사용자. 조직 API 키나 플랫폼 자체가 수행했으면 null이에요.

• testboolean필수

  POST /v1/webhooks/{webhook_id}/test로 보낸 테스트 이벤트.

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "subscription.updated",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "subscription",
    "id": "1"
  },
  "payload": "full",
  "data": {
    "subscription": {
      "edition": "business",
      "status": "active",
      "seats_purchased": 25,
      "billing_interval": "month",
      "trial_ends_at": null,
      "current_period_start": "2026-10-01T00:00:00Z",
      "current_period_end": "2026-11-01T00:00:00Z",
      "canceled_at": null,
      "credits_allowance": 5000
    },
    "previous_attributes": {
      "seats_purchased": 20
    },
    "actor_id": 7
  },
  "test": false
}