Events: Real-Time Visibility into AWS Marketplace Activity

Last updated: August 7, 2025

Clazar enables you to track events happening in your AWS Marketplace account—ranging from listing lifecycle changes to contract revenue reporting—all in real time. You can configure Slack, email, or webhook notifications depending on your preferences.

Whether you’re reconciling revenue, tracking buyer journeys, or preparing for an audit, the Events panel provides full visibility into all activity, with filters to drill down into contract and listing details.

🧩 Event Parameters

1. Origin

Identifies the source of the event:

  • Clazar – Event triggered by Clazar actions

  • AWS – Event triggered by changes reported from AWS

2. Suborigin

Describes what caused the event:

  • SNS

  • Registration

  • Daily Business

  • Disbursements

  • Private Offers

  • Listings

  • Billed Revenue

3. Topic

Classifies the event type. Event topics can be used to filter notifications and configure webhooks.

4. Metadata

Contains event-specific details such as contract entitlements, revenue amounts, and listing identifiers. JSON format varies by topic.

5. Timestamp

The exact datetime the event occurred. Useful for auditing, tracking lifecycle, and correlating external system logs.

🟦 Listing Events

👉 aws.listing.submitted_to_clazar

Description: Triggered when a listing is submitted from your team to Clazar.

Event Details:

  • Origin: Clazar

  • Suborigin: Listings

  • Topic: aws.listing.submitted_to_clazar

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

👉 aws.listing.waiting_on_aws

Description: Listing has been sent to AWS, awaiting their approval.

Event Details:

  • Origin: Clazar

  • Suborigin: Listings

  • Topic: aws.listing.waiting_on_aws

👉 aws.listing.in_limited_state

Description: Listing is now in Limited state; integration testing can begin.

Event Details:

  • Origin: AWS

  • Suborigin: Listings

  • Topic: aws.listing.in_limited_state

👉 aws.listing.published

Description: Listing has gone live on AWS Marketplace 🎉

Event Details:

  • Origin: AWS

  • Suborigin: Listings

  • Topic: aws.listing.published

🟨 Private Offer Events

👉 aws.private_offer.created

Description: Private offer created on AWS Marketplace.

Event Details:

  • Origin: Clazar

  • Suborigin: Private Offers

  • Topic: aws.private_offer.created

Metadata:

{
	offer_name: "Private Offer Name",
  offer_id: "Private Offer Id",
  flexible_payment_enabled: true/false,
  buyers: [{
  	company_name: "Buyer Company Name",
    aws_account_id: "Buyer AWS Account Id"
  }],
  contract_dimensions: [{
  	name: "Dimension",
    api_name: "dimension_api_name",
    description: "Dimension Description",
    units: {Units},
    price: {Price}
  }],
  additional_usage_fees: [{
  	api_name: "dimension_api_name",
    description: "Dimension Description",
    price: {Price}
  }],
  offer_url: "https://example.com",
  flexible_payment_schedule: [{
  	payment_amount: {Amount},
    payment_date: "Payment Date in YYYY-MM-DD format"
  }]
}

🟩 Contract Events

👉 aws.contract.created

Description: Buyer purchased your product; contract created.

Event Details:

  • Origin: AWS

  • Suborigin: SNS

  • Topic: aws.contract.created

Metadata:

{
  product_code: "Product Code",
  customer_identifier: "Customer Identifier",
  entitlements: [{
  	Dimension: "Dimension",
    Value: {
    	IntegerValue/StringValue/DoubleValue/BooleanValue: {Value}
    },
    ExpirationDate: "Expiration Datetime in YYYY-MM-DD HH:MM:SS format"
  }]
}

👉 aws.contract.registered

Description: Buyer completed SaaS registration.

Event Details:

  • Origin: Clazar

  • Suborigin: Registration

  • Topic: aws.contract.registered

Metadata:

{
  product_code: "Product Code",
  customer_identifier: "Customer Identifier",
  registration_details: [{
  	field: "field",
    value: "value"
  }]
}

👉 aws.contract.modified

Description: Contract modified—entitlements changed.

Event Details:

  • Origin: AWS

  • Suborigin: SNS

  • Topic: aws.contract.modified

Metadata:

{
  product_code: "Product Code",
  customer_identifier: "Customer Identifier",
  old_entitlements: [{
  	Dimension: "Old Dimension",
    Value: {
    	IntegerValue/StringValue/DoubleValue/BooleanValue: {Old Value}
    },
    ExpirationDate: "Old Expiration Datetime in YYYY-MM-DD HH:MM:SS format"
  }],
  new_entitlements: [{
  	Dimension: "New Dimension",
    Value: {
    	IntegerValue/StringValue/DoubleValue/BooleanValue: {New Value}
    },
    ExpirationDate: "New Expiration Datetime in YYYY-MM-DD HH:MM:SS format"
  }]
}

👉 aws.contract.renewed

Description: Contract renewed with new expiration.

Event Details:

  • Origin: AWS

  • Suborigin: SNS

  • Topic: aws.contract.renewed

Metadata:

{
  product_code: "Product Code",
  customer_identifier: "Customer Identifier",
  old_entitlements: [{
  	Dimension: "Dimension",
    Value: {
    	IntegerValue/StringValue/DoubleValue/BooleanValue: {Value}
    },
    ExpirationDate: "Old Expiration Datetime in YYYY-MM-DD HH:MM:SS format"
  }],
  new_entitlements: [{
  	Dimension: "Dimension",
    Value: {
    	IntegerValue/StringValue/DoubleValue/BooleanValue: {Value}
    },
    ExpirationDate: "New Expiration Datetime in YYYY-MM-DD HH:MM:SS format"
  }]
}

👉 aws.contract.cancelled

Description: Contract cancelled (expired or revoked).

Event Details:

  • Origin: AWS

  • Suborigin: SNS

  • Topic: aws.contract.cancelled

Metadata:

{
  product_code: "Product Code",
  customer_identifier: "Customer Identifier",
  old_entitlements: [{
  	Dimension: "Dimension",
    Value: {
    	IntegerValue/StringValue/DoubleValue/BooleanValue: {Value}
    }
  }]
}

🟧 Analytics Events

👉 aws.analytics.metered_usage

Description: AWS reports metered usage.

Event Details:

  • Origin: AWS

  • Suborigin: Daily Business

  • Topic: aws.analytics.metered_usage

Metadata:

{
  product_title: "Product Title",
  customer_identifier: "Customer Identifier",
  estimated_revenue: {Amount},
  currency: "Currency",
  user_country: "Buyer's Country",
  user_state: "Buyer's State",
  product_code: "Product Code",
  payer_reference_id: "Payer Reference Id",
  usage_records: [{
  	estimated_revenue: {Amount},
    instance_type: "Dimension",
    usage_units: {Quantity},
    usage_unit_types: "Unit Type",
    offer_id: "Offer Id",
    offer_visibility: "Public/Private"
  }]
}

👉 aws.analytics.contract_fees

Description: AWS reports contract fee transactions.

Event Details:

  • Topic: aws.analytics.contract_fees

Metadata:

{
  product_title: "Product Title",
  customer_identifier: "Customer Identifier",
  total_amount: {Amount},
  currency: "Currency",
  user_country: "Buyer's Country",
  user_state: "Buyer's State",
  product_code: "Product Code",
  payer_reference_id: "Payer Reference Id",
  payer_address_id: "Payer Address Id",
  transactions: [{
  	amount: {Amount},
    dimension: "Dimension",
    quantity: {Quantity},
    start_date: "Start Date",
    end_date: "End Date"
  }]
}

👉 aws.analytics.new_product_subscriber

Description: New buyer reported for a contract.

Event Details:

  • Topic: aws.analytics.new_product_subscriber

Metadata:

{
  product_title: "Product Title",
  customer_identifier: "Customer Identifier",
  offer_id: "Offer Id",
  offer_visibility: "Public/Private",
  user_country: "Buyer's Country",
  user_state: "Buyer's State",
  product_code: "Product Code",
  payer_reference_id: "Payer Reference Id"
}

👉 aws.analytics.canceled_product_subscriber

Description: Buyer contract canceled in AWS reports.

Event Details:

  • Topic: aws.analytics.canceled_product_subscriber

Metadata:

{
  product_title: "Product Title",
  customer_identifier: "Customer Identifier",
  offer_id: "Offer Id",
  offer_visibility: "Public/Private",
  user_country: "Buyer's Country",
  user_state: "Buyer's State",
  product_code: "Product Code",
  payer_reference_id: "Payer Reference Id"
}

👉 aws.analytics.disbursement

Description: AWS disbursed revenue to your account.

Event Details:

  • Topic: aws.analytics.disbursement

Metadata:

{
  product_title: "Product Title",
  agreement_id: "AWS Agreement Id",
  customer_identifier: "Customer Identifier",
  product_code: "Product Code",
  currency: "Currency",
  agreement_start_date: "Agreement Start Date",
  agreement_acceptance_date: "Agreement Acceptance Date",
  agreement_end_date: "Agreement End Date",
  disbursed_net_revenue: {Disbursed Revenue},
  disbursement_date: "Disbursement Date",
  disbursement_period: "Disbursement Period",
  disbursement_status: "Disbursed",
  disbursement_time_in_days_: {Number of Days},
  disburse_bank_trace_id: "Bank Trace Id",
  gross_refund: {Refund},
  gross_revenue: {Revenue},
  invoice_date: "Invoice Date",
  invoice_id: "Invoice Id",
  offer_id: "Offer Id",
  offer_name: "Offer Name",
  offer_visibility: "Public/Private",
  payer_aws_account_id: "Payer's AWS Account Id",
  payer_company_name: "Payer's Company Name",
  payment_due_date: "Due Date",
  payment_terms: "Payment Terms",
  product_id: "Product Id",
  seller_net_revenue: {Net Revenue},
  seller_tax_share: {Seller Tax Share},
  seller_tax_share_refund: {Seller Tax Share Refund},
  subscriber_aws_account_id: "Buyer's AWS Account Id",
  subscriber_company_name: "Buyer's Company Name",
  subscriber_state_or_region: "Buyer's State",
  transaction_reference_id: "Transaction Reference Id",
  undisbursed_net_revenue: {Undisbursed Revenue},
  usage_period_start_date: "Usage Start Date",
  usage_period_end_date: "Usage End Date",
  wholesale_cost: {Wholesale Cost},
  wholesale_cost_refund: {Wholesale Cost Refund}
}

🟥 Error Events

👉 aws.metering.submission_failed

Description: Usage submission to AWS failed.

Event Details:

  • Origin: User

  • Topic: aws.metering.submission_failed

Metadata:

{
  customer_identifier: "Customer Identifier",
  product_code: "Product Code",
  quantity: "2",
  source: "orb",
  dimension: "dim-1",
  extra_info: {
    "error": "You have metered usage for a CustomerIdentifier that does not exist."
  }
}

✅ Final Notes

  • Use event metadata to automate billing, reconciliation, or customer success operations.

  • Events are delivered via Slack, email, or webhook depending on your configuration.

  • The Events Panel in Clazar offers full traceability and filtering options.