# Connect Activity to Mantle and automate your tasks

## Why integrate Activity with Mantle

The Activity to Mantle integration helps you sync data, automate manual tasks, and keep your stack aligned — without writing code.

### See exactly what data flows through each step

Activity Log snapshots variables at any point in a workflow, so you can see what data was present when each step ran. When something behaves unexpectedly, the answer is already in your logs.

### Build an audit trail for every order processed

Add Activity Log steps to order workflows to record what happened, when, and with which data. Every run creates a searchable record your team can reference if questions come up later.

### Confirm the right data reaches each integration

Log the payload before it's sent to an external service to verify the values are correct. Catch mismatched fields, missing data, or formatting errors before they cause a sync to fail.

### Sync Shopify customer data with Mantle subscription records

When a customer's order history, tags, or profile changes in Shopify, MESA updates the corresponding Mantle record. Your subscription analytics and billing data reflect the full picture of each customer, not just their subscription activity.

### Trigger retention workflows when subscription health drops

When Mantle flags a churn risk, a failed payment, or a usage signal, MESA kicks off the right response — a Klaviyo flow, a Slack alert, a Shopify tag update. You act on subscription health signals before they become cancellations.

### Update Shopify customer records when subscription plans change

When a customer upgrades, downgrades, or pauses their plan in Mantle, MESA updates their Shopify tags, fields, and connected tools in real time. Every system reflects the current relationship without manual updates.

## Build any Activity and Mantle automation

MESA helps you connect apps to automate repetitive tasks. A trigger is an event that starts a workflow, and actions are the steps that occur when it's running.

###### Customer Account Deactivated

Starts when a customer account is deactivated.

- ID
- Email
- Tags
- Test
- Mantle
- Shopify
- Icon URL
- Timezone
- URL
- Domain
- Name
- City
- Province
- Country Code
- Currency Code
- Industry
- App Installation
- Billing Status

###### Customer Account Reactivated

Starts when a customer account is reactivated.

###### Customer Activated One Time Charge

Starts when a customer activates a one-time charge.

###### Customer Approaching Capped Limit

Starts when a customer is approaching a usage metric limit.

###### Customer Downgraded

Starts when a customer downgrades their plan.

###### Customer Exceeded Capped Amount

Starts when a customer exceeds the usage metric amount limit.

###### Customer Exceeded Usage Charge Limit

Starts when a customer exceeds the usage charge limit.

###### Customer First Identify

Starts when a customer is first identified by your app.

###### Customer Installed

Starts when a customer installs your app.

###### Customer Refunded

Starts when a customer is refunded a charge.

- Topic
- Event
- App
- Customer
- Subscription
- Transaction

###### Customer Reinstalled

Starts when a customer reinstalls your app.

###### Customer Resubscribed

Starts when a customer resubscribes to a plan after being unsubscribed.

###### Customer Subscribed

Starts when a customer subscribes to one of your app's plans.

###### Customer Trial Expired

Starts when a customer's trial expires.

###### Customer Uninstalled

Starts when a customer uninstalls your app.

###### Customer Unsubscribed

Starts when a customer unsubscribes from one of your app's plans.

###### Customer Updated

Starts when a customer is updated.

###### Customer Upgraded

Starts when a customer upgrades their plan.

###### Customer Usage Event Created

Starts when a customer usage event is created.

###### Customer's Subscription Frozen

Starts when a customer's subscription freezes.

###### Customer's Subscription Unfrozen

Starts when a customer subscription unfreezes.

###### Review Received

Starts when a customer leaves a review.

- ID
- Type
- Date
- App
- Rating
- Edited
- Content
- Location
- Time Spent Using App
- Merchant Name

###### Workflow Error

Starts when a step in the watched workflow fails.

- Workflow ID
- Workflow Name
- Workflow Key
- Task ID
- Run ID
- Error Message
- Step Name

###### Add Customer Tags

Adds tags to a customer.

- ID
- Name
- Email
- Domain
- Shopify Domain
- Tags
- Custom Fields
- App Installations
- Company ID
- Billing Address
- Contacts

###### Archive Plan

Archive a plan. Archived plans can not be mutated.

- ID
- Name
- Description
- Amount
- Currency Code
- Type
- Public
- Visible
- Interval
- Trial Days
- Monthly Revenue
- Lifetime Value
- Average Lifetime Value
- Subscriber Count
- Active Trial Count
- Flex Billing
- Flex Billing Terms
- Deprecated At
- Features
- Customer ID
- Customer Tags
- Customer Exclude Tags
- Shopify Plans
- Created At
- Updated At

###### Create App Feature

Creates a new app feature.

- Name
- Key
- Type
- Default Value
- Description
- Usage Metric ID

###### Create App Usage Metric

Create an app metric for usage.

- Name
- Event Name
- Calculation
- Params

###### Create Company

Create a company.

- Name
- Parent Customer ID

###### Create Contact

Create a contact.

- Name
- Email
- Phone
- Job Title
- Notes
- Tags
- Customers

###### Create Custom Field

Create a custom field.

- App ID
- Name
- Type
- Default Value
- Options
- App Level
- Show On Customer Detail
- Private

###### Create Customer

Create a new customer.

- Name
- Email
- Domain
- Shopify Domain
- Tags
- Custom Fields
- App Installations

###### Create Plan

Create an app plan.

- Name
- Description
- Interval
- Currency Code
- Amount
- Trial Days
- Public
- Visible
- Customer Tags
- Customer Exclude Tags
- Shopify Plans
- Customer
- Plan Usage Charges
- Custom Fields
- Type
- Flex Billing
- Flex Billing Terms
- On Usage Limit Reached
- Auto Upgrade To Plan ID
- Roll Over Pending Usage
- Usage Charge Capped Amount
- Features

###### Create Usage Event

Create a new usage event.

- Timestamp
- Properties
- Customer ID
- App ID
- Event Name
- Event ID
- Private

###### Delete App Feature

Remove an app feature within an organization.

###### Delete App Usage Metric

Remove an app's usage metric.

- Success

###### Delete Company

Remove a company.

###### Delete Contact

Remove a contact.

- Success

###### Delete Custom Field

Remove a custom field.

- Success

###### Get List of App Events

Obtain a list of all app events for a specific app.

- ID
- Type
- App ID
- Customer ID
- App Installation ID
- Transaction ID
- Previous Subscription ID
- Subscription ID
- Occurred At
- Created At
- Updated At

###### Get List of App Features

Obtain a list of an app's features.

- ID
- Name
- Key
- Type
- Description
- Default Value
- Usage Metric
- Created At
- Updated At

###### Get List of App Usage Metrics

Obtain a list of all app's usage metrics.

- ID
- Name
- Event Name
- Calculation
- Params

###### Get List of App's Plans

Obtain a list of app's plans.

- Total
- Plans
- Has More
- Next Cursor

###### Get List of Apps

Obtain a list of all apps that the authenticated user has permission to access.

- ID
- Name
- Display Name
- Created At
- Icon URL
- Slug
- Development

###### Get List of Charges

Obtain a list of all charges for a specific organization.

- ID
- Billed On
- Name
- Customer Name
- Customer Domain
- App Name
- Type
- Status
- Amount
- Currency Code
- Paid On
- Test

###### Get List of Companies

Obtain a list of companies.

- Has Next Page
- Has Previous Page
- Next Cursor
- Previous Cursor
- Companies

###### Get List of Contacts

Obtain a list of all contacts.

- Total
- Has Next Page
- Has Previous Page
- Cursor
- Contacts

###### Get List of Custom Fields

Obtain a list of custom fields.

- ID
- Name
- Type
- Options
- Default Value
- App ID
- App Level
- Show On Customer Detail
- Private

###### Get List of Customer Segments

Obtain a list of all customer segments for the authenticated organization. Only public segments are returned.

- ID
- Name
- Filters

###### Get List of Customers

Obtain a list of all customers.

- Total
- Has Next Page
- Has Previous Page
- Cursor
- Customers

###### Get List of Subscriptions

Obtain a list of subscriptions across all apps and customers.

- ID
- Plan
- Line Items
- Active
- Cancel On
- Billing Cycle Anchor
- Current Period Start
- Current Period End
- Trial Starts At
- Trial Expires At
- Activated At
- Canceled At
- Frozen At
- Features
- Features Order
- Created At
- Confirmation URL
- Shopify Subscription
- Usage Capped Amount
- Usage Balance Used
- Applied Discount
- Subtotal
- Total
- Presentment Subtotal
- Presentment Total

###### Get List of Transactions

Obtain a list of all transactions.

- ID
- Type
- Date
- Processing Fee
- Processing Fee Currency Code
- Net Amount
- Net Amount Currency Code
- Gross Amount
- Gross Amount Currency Code
- Created At
- Updated At
- Subscription ID
- App ID

###### Get List of Usage Events

Obtain a list of usage events.

- ID
- Event ID
- Event Name
- Timestamp
- Properties
- App ID
- Customer ID
- Customer

###### Get List of Users

Obtain a list of all users in an organization.

- ID
- Name
- Email

###### Remove Customer Tags

Remove tags from a customer.

- ID
- Name
- Email
- Domain
- Shopify Domain
- Tags
- Custom Fields
- App Installations
- Company ID
- Billing Address
- Contacts

###### Retrieve App

Grab all details about an app.

- ID
- Name
- Display Name
- Created At
- Icon URL
- Slug
- Development

###### Retrieve App Event

Grab details for a single app event for a specific app.

- ID
- Type
- App ID
- Customer ID
- App Installation ID
- Transaction ID
- Previous Subscription ID
- Subscription ID
- Occurred At
- Created At
- Updated At

###### Retrieve App Feature

Grab all details about an app feature within an organization.

- ID
- Name
- Key
- Type
- Description
- Default Value
- Usage Metric
- Created At
- Updated At

###### Retrieve App Usage Metric

Grab all details about an app's usage metric.

- ID
- Name
- Event Name
- Calculation
- Params

###### Retrieve Company

Grab all details about a company.

- ID
- Name
- Created At
- Parent Customer ID
- Customer Ids
- Updated At

###### Retrieve Contact

Grab all details about a contact.

- ID
- Name
- Email
- Phone
- Job Title
- Label
- Customers
- Notes
- Tags
- Created At
- Updated At

###### Retrieve Custom Field

Grab all details about a custom field.

- ID
- Name
- Type
- Options
- Default Value
- App ID
- App Level
- Show On Customer Detail
- Private

###### Retrieve Customer

Grab all details about a customer.

- ID
- Name
- Email
- Domain
- Shopify Domain
- Tags
- Custom Fields
- App Installations
- Company ID
- Billing Address
- Contacts

###### Retrieve Customer Segment

Grab all details about a customer segment.

- ID
- Name
- Filters

###### Retrieve Organization

Grab all details about an organization.

- ID
- Name
- Customer Tags
- Contact Tags
- Current Installation

###### Retrieve Subscription

Grab all details about a single subscription.

###### Retrieve Transaction

Grab all details about a transaction with the current organization.

###### Retrieve User

Grab all details about a user.

- ID
- Name
- Email

###### Unarchive Plan

Mark a plan as no longer deprecated. It can be mutated after being unarchived.

###### Update App Feature

Modify an app feature within an organization.

- ID
- Name
- Key
- Type
- Description
- Default Value
- Usage Metric
- Created At
- Updated At

###### Update App Usage Metric

Modify an existing app's usage metric.

- Name
- Event Name
- Calculation
- Params

###### Update Company

Modify an existing company.

- Name
- Parent Customer ID

###### Update Contact

Modify an existing contact.

- Name
- Email
- Phone
- Job Title
- Notes
- Tags
- Customers

###### Update Custom Field

Modify an existing custom field.

- App ID
- Default Value
- Options
- App Level
- Show On Customer Detail
- Private

###### Update Customer

Modify an existing customer.

- Name
- Email
- Domain
- Shopify Domain
- Tags
- Custom Fields
- App Installations

###### Update Plan

Modify an existing plan. Certain properties like amount, interval, and currency code cannot be updated.

- Public
- Visible
- Name
- Description
- Deprecated
- Trial Days
- Features
- Needs Review
- Customer Tags
- Customer Exclude Tags
- Shopify Plans
- Customer
- Plan Usage Charges
- Amount
- Interval
- Custom Fields
- Usage Charge Capped Amount
- Base Plan Ids
- Type
- Flex Billing
- Flex Billing Terms
- On Usage Limit Reached
- Auto Upgrade To Plan ID
- Roll Over Pending Usage
- Recurring Interval
- Recurring Interval Count

###### Get Run Details

Look up everything that happened in a single workflow run.

- Run ID
- Status
- Created At
- Workflow ID

###### Log Data

Send specific data to the MESA logs.

- Message
- Payload Values

###### Search Logs

Search your MESA activity history for matching entries.

###### Search Runs

Find past workflow runs by status, label, or keyword.

- Run ID
- Status
- Created At
- Updated At
- Badges
- Task Count
- Failures

## Expert support included

MESA includes hands-on support from automation experts who know how to get things done.

### Free workflow setup

We'll build your first workflow with you live. Most merchants walk away with automation saving 5+ hours/week.

### Fast response times

Average first response: Same day. Critical issues: Immediate escalation. Complex builds: 24-48 hours.

### Ongoing optimization

Personalized workflow reviews, and quarterly check-ins to identify new opportunities as your business grows.

### Real humans, always

Chat with real automation experts (not bots). Email support 9am-5pm PST. Google Meet sessions for complex workflows.

## Integrate Activity with Mantle today.

Enjoy a 7-day free trial. Get your first workflow in minutes.
