• Home
/
• Explore m3ter Documentation
/
• Integrations
/
• Setting Up and Managing Native and Notification Integrations

Creating and Managing Integration Configurations

An Integration Configuration in m3ter consists of two parts:

• Configuration to control how m3ter data will be synchronized with your 3rd-party system.

• Configuration for authentication to allow connection to an integration Destination.

You can perform both parts of this overall set up in the Console for either Native or Notification Integration Configurations:

• A Native Integration Configuration allows you to implement an outbound integration to send billing data for end-customer Accounts outbound into your 3rd-party invoicing and finance systems as Destinations.

• A Notification Integration Configuration allows you to implement notifications triggered by m3ter system Events to be sent out to webhooks as Destinations.

This topic provides general guidance on how to create both types of Integration Configuration, and links you out to detailed guidance on how to complete Integration Configurations. When you create either type, they are listed on the Integration Configurations page in the Console. From there, you can manage you Integration Configurations to edit and review details:

• Creating and Managing Native Integration Configurations

• Creating and Managing Notification Integration Configurations

Creating and Managing Native Integration Configurations

Creating Native Integration Configurations

You can create Native Integration Configurations for an outbound billing data flow into five 3rd-party systems as Destinations. For detailed guidance on how to achieve this, please see the relevant specific topics in this section of the documentation:

• Configuring Stripe Integrations

• Configuring Netsuite Integrations

• Configuring Chargebee Integrations

• Configuring QuickBooks Integrations

• Configuring Xero Integrations

Reviewing and Managing Native Integrations

To review and manage Native Integrations:

1. Select Integration>Configurations. The Integration Configurations page opens.

2. Select the Edit button for the Native Integration you want to edit:

The Edit page opens and shows the Entity Type and Integration Destination at the top of the page.

3. Make the required editing changes and select Update. You are returned to the Integrations Configurations page.

4. If you want to review the details of a Native Integration, select the ENTITY TYPE hotlink text for the Integration. The Integration Details page opens:

In this example, we've open the details for a Bill - QuickBooks Native Integration. Note that:

• We can see that the Integration Connection is currently DISCONNECTED from the QuickBooks system:

  • If you want to connect the Integration, select Connect. An authentication modal appears, which you can use to set up the required authentication credentials for connecting the integration. See the relevant topic for configuring specific Native Integration connection credentials - links are given above at the beginning of this section.

• The Configuration data is given in JSON format. You can copy this directly to your clipboard.

5. Select the Integration Configurations breadcrumb link at the top of the page to return to the Integration Configurations page.

6. If you want to remove a Native Integration, select delete:

A confirmation popup appears.

7. Select Yes to confirm the delete action.

Creating and Managing Notification Integration Configurations

Creating Notification Integration Configurations

To create a Notification Integration Configuration, you must first create a Notification rule based on a system Event. You can then link this Notification Rule to a webhook Destination. When you make this link, it creates a Notification Integration Configuration, which is then listed on the Integration Configurations page.

For details on how to create Notification Rules based on system Events and link them to integration webhook Destinations, see Creating, Managing, and Reviewing Notifications.

Reviewing and Managing Notification Integration Configurations

To review and manage Notification Integrations:

1. Select Integration>Configurations. The Integration Configurations page opens.

2. Select the Edit button for the Notification Integration you want to edit:

The Edit page opens and shows the Entity Type and Integration Destination at the top of the page:

You can configure which Accounts you want to include or exclude for the Notification Configuration:

• Suppose you've set up a Notification based on a config.commitment.created system Event and for the Notification to be triggered only when the new commitment created for an Account is greater than or equal to $10,000. You might want this Notification to be operative for only five of your end-customer Accounts. In this case, use the Account Ids drop-down to select the five Accounts.

• If you want the Notification to be operative for all Accounts, leave both the Account Ids and Restricted Account Ids fields blank.

3. Make the required editing changes and select Update. You are returned to the Integrations Configurations page.

4. If you want to review the details of a Notification Integration, select the ENTITY TYPE hotlink text for the Integration. The Integration Details page opens:

Note that you can read-off and copy directly to your clipboard:

• The Entity ID.

• The Destination ID.

• The Configuration data in JSON format. In this example, two Accounts have been selected as those the Notification will be triggered for.

The Last Completed Integration Date is also given. You can select the date hotlink text to review the details of this last completed run - see Reviewing Notification Integration Runs for details.

5. Select the Integration Configurations breadcrumb link at the top of the page to return to the Integration Configurations page.

6. If you want to remove a Notification Integration, select delete:

A confirmation popup appears.

7. Select Yes to confirm the delete action.

Next: Configuring Stripe Integrations