mantle

name	mantle
description	Search Mantle contacts and customers, or fetch a customer by ID, using the Mantle Core API. Use when working in Mantle/HeyMantle and needing to list contacts, list customers with any documented query parameter, or retrieve a customer by ID.
metadata	{"openclaw":{"requires":{"env":["ACCESS_TOKEN"]}}}

Mantle Skill

Use this skill to query Mantle read-only data via the Core API.

Available actions

• Search contacts with any documented GET /v1/contacts query parameter.
• Search customers with any documented GET /v1/customers query parameter.
• Fetch a customer by ID with GET /v1/customers/{id}.

Rules

• Keep this skill read-only.
• Do not invent parameters; pass through only documented query params or explicit caller input.
• Use the access token from OpenClaw config. Do not hardcode secrets.
• For list endpoints, allow the caller to pass any supported filter/sort/pagination parameter.

Usage

const { searchContacts, searchCustomers, getCustomerById } = require('./index');

await searchContacts({ search: 'acme', take: 50 });
await searchCustomers({ email: '[e-mail]', sort: 'updatedAt', sortDirection: 'desc' });
await getCustomerById('cust_123');

Parameters

Contacts

Supported by searchContacts(options):

• page
• take
• sort
• search
• minUpdatedAt
• maxUpdatedAt
• appIds
• shopifyShopDomain
• domain
• shopifyShopId
• email

Customers

Supported by searchCustomers(options):

• page
• take
• sort
• sortDirection
• cursor
• search
• minUpdatedAt
• maxUpdatedAt
• appIds
• shopifyShopDomain
• domain
• shopifyShopId
• email

Customer lookup

getCustomerById(id, options) accepts:

• id required
• options pass-through query params if the endpoint supports them