Guides

Events

Suggest Edits

Events help tracking what's happening in your marketplace account. Clazar provides visibility into everything on Azure Marketplace. Whether it's your listing getting published or whether the contract is pending or accepted. Through events you get realtime notifications on when a buyer subscribed to your listing. You're notified on events through various channels, like slack, email, and webhooks depending upon your Clazar account settings.

You can also configure what events you want to get notified on. In case you missed any event, you can go to your Clazar account, navigate to Events panel and see all your events there. The panel facilitates you with filters you need to track down the journey of your contracts. Events makes to easier for your finance team to reconcile payments, customer success team to track down contract journey and auditors to find financial insights.

Event Parameters

Origin

Origin of an event tells you was it Clazar or Azure to initiate the change that triggered the event. There are a certain events that are caused by changes at Azure, like a contract getting renewed. While there are some events which are solely created by Clazar, like registration details being updated by the buyer. The possible values for event origin are Clazar and Azure.

Suborigin

Suborigin of an event tells you what caused the event. The event can be driven by Clazar receiving a webhook from Azure or buyer filling out the registration details. Following are the possible values for suborigin.

  1. Landing Page
  2. Registration
  3. User
  4. Webhook
  5. Listings

Topic

An event topic classifies what kind of event it is. On the basis of topic you can interpret what exactly changed in your Azure marketplace account. Some events might provide business critical information, while some might be related to finance operations. You can configure what events you receive via webhook using event topics. More information on topic is provided in the next section of this documentation.

Metadata

Metadata provides in-depth information of what an event denotes. Like in can a new contract is created you can refer to metadata for contract entitlements and other related information specific to that contract. In case a contract is modified you can use metadata to infer the changes in entitlements that happened. Event from different topic can have different structure of metadata. More information is provided in the next section.

Timestamp

Timestamp is a Datetime parameter that denotes when exactly the event was triggered. You can use timestamp to track the journey of a contract or a specific transaction.

Event Details

azure.listing.submitted_to_clazar

This event is triggered when you/your team submits the listing. We'll now send the listing to Azure. Here's what receive in an event when a listing is submitted.

📘

Event Details

Origin: Clazar

Suborigin: Listings

Topic: azure.listing.submitted_to_clazar

Text: Listing Submitted to Clazar

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

Metadata:

Here's what you see on your slack channel:

azure.listing.in_limited_state

📘

Event Details

Origin:Clazar

Suborigin: Listings

Topic: azure.listing.submitted_to_clazar

Text: Listing in Limited State

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

Metadata:

Here's what you see on your slack channel:

azure.listing.published

📘

Event Details

Origin:Clazar

Suborigin: Listings

Topic: azure.listing.published

Text: Listing Published in Azure

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

Metadata:

Here's what you see on your slack channel:

azure.contract.pending

📘

Event Details

Origin: Azure

Suborigin: Landing Page

Topic: azure.contract.pending

Text: Contract Pending

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

Metadata:

{
  "offer_id": "listing-id",
  "subscription_id": "1896d5c7-a84a-4ec0-cd24-44690a802176",
  "beneficiary": {
    "pu_id": "100320026EEB7859",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "1d618ab7-dd63-4b3d-8491-3325212ad772"
  },
  "purchaser": {
    "pu_id": "100320026EEB7859",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "1d618ab7-dd63-4b3d-8491-3325212ad772"
  },
  "entitlements": {
    "plan_id": "kickoff",
    "plan_name": "Kick Off",
    "is_free_trial": false,
    "billing_term": "1 Month",
    "dimensions": [
      {
        "dimension_name": "API Requests",
        "included_quantity": 35000
      },
      {
        "dimension_name": "Integration involvement xxxx xxxxxxxx"
      }
    ]
  }
}

Here's what you see on your slack channel:

azure.contract.registered

📘

Event Details

Origin: Clazar

Suborigin: Registration

Topic: azure.contract.registered

Text:Registration Updated

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

Metadata:

{
  "offer_id": "listing-id",
  "subscription_id": "a0ccd506-1336-4eb1-dd07-8ae8a1bc205f",
  "beneficiary": {
    "pu_id": "100320026EEB7859",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "1d618ab7-dd63-4b3d-8491-3325212ad772"
  },
  "purchaser": {
    "pu_id": "100320026EEB7859",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "1d618ab7-dd63-4b3d-8491-3325212ad772"
  },
  "registration_details": [
    {
      "field": "Company Name",
      "value": "Acme Corp"
    },
    {
      "field": "Full Name",
      "value": "Purchase Full Name"
    },
    {
      "field": "Email Address",
      "value": "[email protected]"
    },
    {
      "field": "Cloud Provider",
      "value": "Azure"
    }
  ]
}

Here's what you see on your slack channel:

azure.contract.activated

📘

Event Details

Origin: Clazar

Suborigin: User

Topic: azure.contract.activated

Text: Contract Activated

Description: Azure contract activated for listing {listing-title}.

Metadata:

{
  "offer_id": "listing-id",
  "subscription_id": "a9ede1cd-9105-4abd-d400-7a19cc72d80d",
  "beneficiary": {
    "pu_id": "10032002AB0ED8C5",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "4c69d4eb-a270-4818-9aec-2f701206b843"
  },
  "purchaser": {
    "pu_id": "10032002AB0ED8C5",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "4c69d4eb-a270-4818-9aec-2f701206b843"
  },
  "start_date": "2023-10-19T00:00:00.000Z",
  "end_date": "2023-11-18T00:00:00.000Z",
  "entitlements": {
    "plan_id": "basic",
    "plan_name": "Basic",
    "is_free_trial": false,
    "billing_term": "1 Month",
    "dimensions": [
      {
        "dimension_name": "API Requests",
        "included_quantity": 40000
      },
      {
        "dimension_name": "Integration involvement xxxx xxxxxxxx"
      }
    ]
  }
}

Here's what you see on your slack channel:

azure.contract.quantity_changed

📘

Event Details

Origin: Azure

Suborigin: Webhook

Topic: azure.contract.quantity_changed

Text: Contract No. of Users Changed

Description: Azure contract no. of users changed for listing {listing-title}.

Metadata:

{
  "offer_id": "listing-id",
  "subscription_id": "79837f0e-4f89-4f18-d502-4332b17faa52",
  "beneficiary": {
    "pu_id": "100320029C61C1E0",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "70e78f1c-5838-4c5f-a047-90efbd1d5087"
  },
  "purchaser": {
    "pu_id": "100320029C61C1E0",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "70e78f1c-5838-4c5f-a047-90efbd1d5087"
  },
  "new_entitlements": {
    "plan_id": "basic_user",
    "plan_name": "Basic User",
    "is_free_trial": false,
    "billing_term": "1 Month",
    "number_of_users": 6
  },
  "old_entitlements": {
    "plan_id": "basic_user",
    "plan_name": "Basic User",
    "is_free_trial": false,
    "billing_term": "1 Month",
    "number_of_users": 2
  }
}

Here's what you see on your slack channel:

azure.contract.plan_changed

📘

Event Details

Origin: Azure

Suborigin: Webhook

Topic: azure.contract.plan_changed

Text: Contract Plan Changed

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

Metadata:

{
  "offer_id": "listing-id",
  "subscription_id": "f0039812-2a04-4ff4-dc9c-c173164d4215",
  "beneficiary": {
    "pu_id": "100320026EEB7859",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "1d618ab7-dd63-4b3d-8491-3325212ad772"
  },
  "purchaser": {
    "pu_id": "100320026EEB7859",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "1d618ab7-dd63-4b3d-8491-3325212ad772"
  },
  "new_entitlements": {
    "plan_id": "starter",
    "plan_name": "Starter",
    "is_free_trial": false,
    "billing_term": "1 Month",
    "dimensions": [
      {
        "dimension_name": "API Requests",
        "included_quantity": 180000
      },
      {
        "dimension_name": "Integration involvement xxxx xxxxxxxx"
      }
    ]
  },
  "old_entitlements": {
    "plan_id": "basic",
    "plan_name": "Basic",
    "is_free_trial": false,
    "billing_term": "1 Month",
    "dimensions": [
      {
        "dimension_name": "API Requests",
        "included_quantity": 40000
      },
      {
        "dimension_name": "Integration involvement xxxx xxxxxxxx"
      }
    ]
  }
}

Here's what you see on your slack channel:

azure.contract.renewed

📘

Event Details

Origin: Azure

Suborigin: Webhook

Topic: azure.contract.renewed

Text: Contract Renewed

Description: Azure contract renewed for listing {listing-title}.

Metadata:

{
  "offer_id": "listing-id",
  "subscription_id": "586731e6-4c75-459d-c181-ff9c3079d670",
  "beneficiary": {
    "pu_id": "100320029C61C1E0",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "70e78f1c-5838-4c5f-a047-90efbd1d5087"
  },
  "purchaser": {
    "pu_id": "100320029C61C1E0",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "70e78f1c-5838-4c5f-a047-90efbd1d5087"
  },
  "start_date": "2023-07-20T00:00:00.000Z",
  "end_date": "2023-08-19T00:00:00.000Z",
  "entitlements": {
    "plan_id": "basic_user",
    "plan_name": "Basic User",
    "is_free_trial": false,
    "billing_term": "1 Month",
    "number_of_users": 7
  }
}

Here's what you see on your slack channel:

azure.contract.suspended

📘

Event Details

Origin: Azure

Suborigin: Webhook

Topic: azure.contract.suspended

Text: Contract Suspended

Description: Azure contract suspended for listing {listing-title}.

Metadata:

{
  "offer_id": "clazar_cloud_gtm_platform",
  "subscription_id": "cc33e92e-1aad-4706-deea-a3626817fa48",
  "beneficiary": {
    "pu_id": "10032000973B0B44",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "0900ce17-75fd-4d1b-b5ef-bbda158669b7"
  },
  "purchaser": {
    "pu_id": "10032000973B0B44",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "0900ce17-75fd-4d1b-b5ef-bbda158669b7"
  },
  "entitlements": {
    "plan_id": "clazar",
    "plan_name": "Clazar Cloud GTM Platform",
    "is_free_trial": false,
    "billing_term": "1 Year",
    "dimensions": [
      {
        "dimension_name": "Additional Platform Utilization"
      }
    ]
  }
}

Here's what you see on your slack channel:

azure.contract.unsubscribed

📘

Event Details

Origin: Azure

Suborigin: Webhook

Topic: azure.contract.unsubscribed

Text: Contract Unsubscribed

Description: Azure contract unsubscribed for listing {listing-title}.

Metadata:

{
  "offer_id": "listing-id",
  "subscription_id": "45330938-3b96-4f66-de8f-6594401daaf8",
  "beneficiary": {
    "pu_id": "100320026EEB7859",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "1d618ab7-dd63-4b3d-8491-3325212ad772"
  },
  "purchaser": {
    "pu_id": "100320026EEB7859",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "1d618ab7-dd63-4b3d-8491-3325212ad772"
  },
  "entitlements": {
    "plan_id": "kickoff",
    "plan_name": "Kick Off",
    "is_free_trial": false,
    "billing_term": "1 Month",
    "dimensions": [
      {
        "dimension_name": "API Requests",
        "included_quantity": 35000
      },
      {
        "dimension_name": "Integration involvement xxxx xxxxxxxx"
      }
    ]
  }
}

Here's what you see on your slack channel:

azure.contract.reinstated

📘

Event Details

Origin: Azure

Suborigin: Webhook

Topic: azure.contract.reinstated

Text: Contract Reinstated

Description: Azure contract reinstated for listing {listing-title}.

Metadata:

{
  "offer_id": "clazar_cloud_gtm_platform",
  "subscription_id": "cc33e92e-1aad-4706-deea-a3626817fa48",
  "beneficiary": {
    "pu_id": "10032000973B0B44",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "0900ce17-75fd-4d1b-b5ef-bbda158669b7"
  },
  "purchaser": {
    "pu_id": "10032000973B0B44",
    "email_id": "[email protected]",
    "tenant_id": "10v8ebfe-c820-43e8-9826-67e18810e2a3",
    "object_id": "0900ce17-75fd-4d1b-b5ef-bbda158669b7"
  },
  "entitlements": {
    "plan_id": "clazar",
    "plan_name": "Clazar Cloud GTM Platform",
    "is_free_trial": false,
    "billing_term": "1 Year",
    "dimensions": [
      {
        "dimension_name": "Additional Platform Utilization"
      }
    ]
  }
}

Here's what you see on your slack channel:



azure.metering.submission_failed

This event is triggered when usage reporting to Azure fails. Here are the event details:

📘

Event Details

Origin: User

Suborigin: User

Topic: azure.metering.submission_failed

Text: Azure Metering Submission Failed

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

Metadata:

{
  subscription_id: "cc33e92e-1aad-4706-deea-a3626817fa48",
  quantity: "2.3",
  dimension: "dim-1",
  source: "orb",
  extra_info: {
    "error": "Duplicate"
  }
}

Updated 6 months ago