# M3ter Events API **Canonical:** https://apis.io/apis/m3ter/m3ter-events-api/ **Provider:** M3ter — https://apis.io/providers/m3ter/ **Base URL:** https://api.m3ter.com **Documentation:** https://www.m3ter.com/ M3ter Events API is one of 58 APIs that [M3ter](https://apis.io/providers/m3ter/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Event. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and a getting-started guide. This section provides Endpoints for operations that allow you to retrieve detailed information about individual Events, list all Events or specific Event Types, and explore dynamic fields available for each Event Type. Events encompass specific instances of state changes within the system, such as the creation of a new Prepayment/Commitment for an Account. Each Event is classified under an Event Type framework, providing context about what kind of change occurred to generate the Event. **Events for Configuration and Billing Entities** Many Event Types cover common configuration and billing objects, where the Event is generated for a state change of one of these objects - for when the configuration or billing object is **created**, **deleted**, or **updated**. For example: * configuration.commitment.created * configuration.commitment.deleted * configuration.commitment.updated * configuration.account.created * configuration.account.deleted * configuration.account.updated * billing.bill.created * billing.bill.deleted * billing.bill.created **Events for Errors or Failures** There are also Event Types for certain kinds of error that can occur: * For an Integration: * validation * authentication * perform * missing account mapping * disabled * For a Usage Data Ingest Submission: * validation failure * For Data Export Jobs: * data export job failure **Scheduled Events** In addition to system-generated Events that occur when a configuration entity undergoes a state change at creation, update, or deletion of the entity, you can use API calls to create and configure *Scheduled Event Configurations*. Scheduled Events are custom Event types, which you can set up by referencing Date/Time fields on configuration and billing entities. See the [ScheduledEventConfigurations](https://www.m3ter.com/docs/api#tag/ScheduledEventConfigurations) section of this API Reference for more details. **Notifications for Events** You can create Notification rules based on Events and these rules can reference and apply calculations to the Event's fields. This allows you to set up customized alerts to be sent out via webhooks when the Event occurs and any conditions you've built into the Notification rule's calculation are satisfied. See the [Notifications](https://www.m3ter.com/docs/api#tag/Notifications) section for more details. **Other Events** When Events occur, they can cause other Events, such as when a Notification is triggered by the Event it is based on. For these Events there are currently two categories: * Notification * IntegrationEvent Also see [Utilizing Events and Notifications](https://www.m3ter.com/docs/guides/utilizing-events-and-notifications) and [Object Definitions and API Calls](https://www.m3ter.com/docs/guides/utilizing-events-and-notifications/object-definitions-and-api-calls) in the m3ter documentation for more guidance. ## Machine-readable artifacts (11) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/m3ter/refs/heads/main/openapi/m3ter-events-api-openapi.yml - **Documentation** — https://docs.m3ter.com/ - **APIReference** — https://docs.m3ter.com/api - **Authentication** — https://docs.m3ter.com/api/authentication - **GettingStarted** — https://www.m3ter.com/docs/guides/m3ter-apis/getting-started-with-api-calls - **SDKs** — https://github.com/m3ter-com/m3ter-sdk-python - **SDKs** — https://github.com/m3ter-com/m3ter-sdk-node - **SDKs** — https://github.com/m3ter-com/m3ter-sdk-java - **SDKs** — https://github.com/m3ter-com/m3ter-sdk-go - **SDKs** — https://github.com/m3ter-com/m3ter-sdk-typescript - **TerraformProvider** — https://github.com/m3ter-com/terraform-provider-m3ter ## Other M3ter APIs (12) - [M3ter Account API](https://apis.io/apis/m3ter/m3ter-account-api/) - [M3ter AccountPlan API](https://apis.io/apis/m3ter/m3ter-accountplan-api/) - [M3ter Aggregation API](https://apis.io/apis/m3ter/m3ter-aggregation-api/) - [M3ter Auth API](https://apis.io/apis/m3ter/m3ter-auth-api/) - [M3ter BalanceChargeSchedule API](https://apis.io/apis/m3ter/m3ter-balancechargeschedule-api/) - [M3ter Balances API](https://apis.io/apis/m3ter/m3ter-balances-api/) - [M3ter BalanceTransactionSchedule API](https://apis.io/apis/m3ter/m3ter-balancetransactionschedule-api/) - [M3ter Bill API](https://apis.io/apis/m3ter/m3ter-bill-api/) - [M3ter BillConfig API](https://apis.io/apis/m3ter/m3ter-billconfig-api/) - [M3ter BillGroupingKey API](https://apis.io/apis/m3ter/m3ter-billgroupingkey-api/) - [M3ter BillJob API](https://apis.io/apis/m3ter/m3ter-billjob-api/) - [M3ter Charge API](https://apis.io/apis/m3ter/m3ter-charge-api/) ## Tags Event --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/m3ter/m3ter-events-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/m3ter/.