GCP Events with Clazar

Last updated: August 8, 2025

Events help you track what’s happening in your GCP Marketplace account. Clazar provides visibility into everything—whether it’s your listing getting published 📄 or a new contract being created or renewed.

Through real-time notifications, you get alerts when a buyer subscribes to your listing. Notifications are sent through Slack, email, and webhooks, depending on your Clazar account settings.

You can configure the events you wish to receive. If you miss a notification, just go to your Clazar Events panel to view all past events and use filters to trace contract journeys. Events tied to specific buyers are also visible on the respective buyer's screen.

🧩 Event Parameters

Each event in Clazar contains a set of data, which can be:

  • Static: Defines the nature of the event (e.g. type, who triggered it, GCP or Clazar).

  • Dynamic: Provides specific details (e.g. which buyer purchased which contract).

🔹 Origin

Tells whether the event was triggered by Clazar or GCP.

Examples:

  • Clazar: e.g. registration update by buyer

  • GCP: e.g. contract renewal

🔹 Suborigin

Describes what caused the event.

Possible values:

  • Pub/Sub

  • Registration

  • Listings

🔹 Topic

Classifies the event type. You can use topics to:

  • Filter events

  • Configure webhook notifications

  • Interpret what exactly changed in your partner account

🔹 Metadata

Contains detailed information about the event.

Examples:

  • New contract: shows plan and entitlement details

  • Plan change: shows old vs. new plan

⚠ Different topics have different metadata structures.

🔹 Timestamp

Shows when the event occurred.
Useful for tracking contract or transaction lifecycles.

📘 Event Details

Below are the documented GCP event types supported in Clazar, with full metadata included.

👉 gcp.listing.submitted_to_clazar

Triggered when: Your team submits the listing to Clazar.

Event Details:

  • Origin: Clazar

  • Suborigin: Listings

  • Topic: gcp.listing.submitted_to_clazar

  • Text: Listing Submitted to Clazar

  • Description: Listing {listing-title} on GCP is submitted to Clazar.

👉 gcp.listing.waiting_on_gcp

Triggered when: The listing is submitted to GCP.

Event Details:

  • Origin: Clazar

  • Suborigin: Listings

  • Topic: gcp.listing.waiting_on_gcp

  • Text: Listing Submitted to GCP

  • Description: Listing {listing-title} is submitted to GCP.

👉 gcp.listing.in_limited_state

Triggered when: The listing is in Limited state.

Event Details:

  • Origin: GCP

  • Suborigin: Listings

  • Topic: gcp.listing.in_limited_state

  • Text: Listing in Limited State

  • Description: Listing {listing-title} is now published in Limited state on GCP.

👉 gcp.listing.published

Triggered when: Listing is published on GCP Marketplace 🥳

Event Details:

  • Origin: GCP

  • Suborigin: Listings

  • Topic: gcp.listing.published

  • Text: Listing Published in GCP

  • Description: Listing {listing-title} is now published on GCP Marketplace.

👉 gcp.contract.pending

Triggered when: Buyer purchases the product (contract pending activation).

Event Details:

  • Origin: GCP

  • Suborigin: Pub/Sub

  • Topic: gcp.contract.pending

  • Text: Contract Pending

  • Description: GCP contract created in pending activation state for listing {listing-title}.

Metadata:

{
  "company_name": "Buyer Company Name",
  "domain": "Buyer Domain",
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "email_id": "Buyer Email Id",
  "plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term"
  }
}

👉 gcp.contract.registered

Triggered when: Buyer completes SaaS registration.

Event Details:

  • Origin: Clazar

  • Suborigin: Registration

  • Topic: gcp.contract.registered

  • Text: Registration Updated

  • Description: GCP buyer registration details updated for listing {listing-title}.

Metadata:

{
  "company_name": "Buyer Company Name",
  "domain": "Buyer Domain",
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "email_id": "Buyer Email Id",
  "registration_details": [{
    "field": "Registration Field",
    "value": "Field Value Buyer entered"
  }]
}

👉 gcp.contract.activated

Triggered when: Contract is activated. Billing has started.

Event Details:

  • Origin: GCP

  • Suborigin: Pub/Sub

  • Topic: gcp.contract.activated

  • Text: Contract Activated

  • Description: GCP contract activated for listing {listing-title}.

Metadata:

{
  "company_name": "Buyer Company Name",
  "domain": "Buyer Domain",
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "email_id": "Buyer Email Id",
  "plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  }
}

👉 gcp.contract.plan_change_initiated

Triggered when: A contract plan change is requested by the buyer or initiated through acceptance of a new private offer while an existing contract is ongoing.

Event Details:

  • Origin: GCP

  • Suborigin: Pub/Sub

  • Topic: gcp.contract.plan_change_initiated

  • Text: Contract Plan Change Initiated

  • Description: GCP contract plan change initiated for listing {listing-title}

Metadata:

{
  "company_name": "Buyer Company Name",
  "domain": "Buyer Domain",
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "email_id": "Buyer Email Id",
  "upcoming_plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  },
  "current_plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  }
}

👉 gcp.contract.plan_changed

Triggered when: A contract plan change becomes effective.

Event Details:

  • Origin: GCP

  • Suborigin: Pub/Sub

  • Topic: gcp.contract.plan_changed

  • Text: Contract Plan Changed

  • Description: GCP contract plan changed for listing {listing-title}.

Metadata:

{
  "company_name": "Buyer Company Name",
  "domain": "Buyer Domain",
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "email_id": "Buyer Email Id",
  "new_plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  },
  "old_plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  }
}

👉 gcp.contract.plan_change_canceled

Triggered when: A plan change initiated by the buyer is revoked.

Event Details:

  • Origin: GCP

  • Suborigin: Pub/Sub

  • Topic: gcp.contract.plan_change_canceled

  • Text: Contract Plan Change Canceled

  • Description: GCP contract plan change canceled for listing {listing-title}.

Metadata:

{
  "company_name": "Buyer Company Name",
  "domain": "Buyer Domain",
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "email_id": "Buyer Email Id",
  "canceled_plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  },
  "current_plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  }
}

👉 gcp.contract.renewed

Triggered when: A contract is renewed and extended.

Event Details:

  • Origin: GCP

  • Suborigin: Pub/Sub

  • Topic: gcp.contract.renewed

  • Text: Contract Renewed

  • Description: GCP contract renewed for listing {listing-title}.

Metadata:

{
  "company_name": "Buyer Company Name",
  "domain": "Buyer Domain",
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "email_id": "Buyer Email Id",
  "start_at": "Start time of the contract in YYYY-MM-DD HH:MM:SS format",
  "end_at": "New end time of the contract in YYYY-MM-DD HH:MM:SS format",
  "plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  }
}

👉 gcp.contract.canceled

Triggered when: A contract is canceled—either expired or revoked by the buyer.

Event Details:

  • Origin: GCP

  • Suborigin: Pub/Sub

  • Topic: gcp.contract.canceled

  • Text: Contract Canceled

  • Description: GCP contract canceled for listing {listing-title}.

Metadata:

{
  "company_name": "Buyer Company Name",
  "domain": "Buyer Domain",
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "email_id": "Buyer Email Id",
  "plan_details": {
    "plan_id": "Plan Id",
    "offer_type": "Offer Type - Private/Public",
    "offer_id": "Offer Id",
    "offer_term": "Offer Term",
    "offer_end_time": "Offer End Time in YYYY-MM-DD HH:MM:SS format",
    "offer_start_time": "Offer Start Time in YYYY-MM-DD HH:MM:SS format"
  }
}

👉 gcp.metering.submission_failed

Triggered when: Usage reporting to GCP fails.

Event Details:

  • Origin: User

  • Suborigin: User

  • Topic: gcp.metering.submission_failed

  • Text: GCP Metering Submission Failed

  • Description: Metering submission to GCP failed for dimension {dimension} and quantity {quantity}.

Metadata:

{
  "entitlement_id": "GCP Entitlement Id",
  "account_id": "Buyer Account Id",
  "quantity": "2.3",
  "dimension": "dim-1",
  "source": "orb",
  "extra_info": {
    "error": "Invalid metric ID"
  }
}

✅ Summary

  • Clazar offers complete visibility into GCP Marketplace events, with metadata for deep context.

  • You can access historical events and configure which ones are delivered via Slack, email, or webhook.

  • Events are grouped by listing state, buyer contract activity, plan transitions, and metering.