update_contact
Update Contact
Update a contact's attributes such as name, phone, birthdate, or any custom attributes. System-managed values like credit balance and creation date cannot be updated through this tool.
Supported Tools
delete_contact
Delete Contact
Delete a contact from the loyalty system. Supports standard deletion or GDPR-compliant deletion which ensures full data removal. This is an asynchronous operation.
list_contacts
List Contacts
List loyalty program contacts with filtering and pagination. Use this to browse contacts, find recently created contacts, or retrieve a paginated list of all contacts in the system.
create_contact
Create Contact
Create a new contact in the loyalty system. Supports creating a contact by email, finding or creating by email (idempotent), or creating an anonymous contact. Use **findOrCreate** mode to avoid duplicates.
manage_giftcards
Manage Gift Cards
Create, list, get, and find gift cards. Also supports creating transactions (adding/deducting balance) on gift cards. Gift cards are anonymous and not linked to contacts.
list_rewards
List Rewards
List available rewards in the loyalty program. Optionally filter by shop or contact to see which rewards are claimable by a specific contact.
list_loyalty_transactions
List Loyalty Transactions
List loyalty transactions including credit receptions and reward receptions. Filter by contact, shop, type, and date range to track credit activity.
get_loyalty_program
Get Loyalty Program
Retrieve the loyalty program configuration including program name, max credit amount, custom credit name, and unit settings. Also lists available tiers and gift card programs.
list_shops
List Shops
List all shops connected to the account. Shops represent physical locations or web shops and are required for many operations like awarding credits, redeeming vouchers, and gift card transactions.
manage_vouchers
Manage Vouchers
Create, list, find, update, or redeem vouchers. Vouchers are tied to promotions and can be assigned to contacts. Use this tool to manage the entire voucher lifecycle.
manage_prepaid
Manage Prepaid Balance
Manage a contact's prepaid balance. Create transactions to top up or deduct from prepaid balance, list transaction history, or check current balance. Prepaid balances are linked directly to contacts.
manage_contact_identifiers
Manage Contact Identifiers
Create, find, link, or unlink contact identifiers. Contact identifiers are used to associate physical cards, QR codes, or other identifiers with contacts in the loyalty system.
list_promotions
List Promotions
List all promotions in the account. Promotions define voucher campaigns and are required when creating vouchers. Optionally retrieve a single promotion by UUID.
claim_reward
Claim Reward
Claim a reward for a contact, deducting the required credits from their balance. Also supports reversing a previously claimed reward to restore credits.
get_contact
Get Contact
Retrieve a single contact by UUID or email address. Also returns the contact's credit balance, prepaid balance, tier, and identifiers in a single call.
trigger_automation
Trigger Automation
Trigger an automation run for a specific contact. Automations are workflows configured in the Piggy dashboard that can send emails, award credits, or perform other actions. Optionally list available automations.
award_credits
Award Credits
Award loyalty credits to a contact. Credits can be awarded directly by specifying a credit amount, or calculated from a unit value (e.g. purchase amount). Use this to reward customers for purchases or other activities.
More integrations teams use with Piggy
Hubspot
Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings. Subscribe to webhooks for real-time notifications on object creation, deletion, property changes, merges, and association changes.
Salesforce
Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Subscribe to real-time change events via Change Data Capture and Platform Events. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.
Apolloio
Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.
Attio
Manage a customizable CRM workspace including records, lists, notes, tasks, and comments. Create, read, update, delete, and search records across standard and custom objects (people, companies, deals). Upsert records using unique attributes to avoid duplicates. Organize records into lists (e.g., sales pipelines) and manage list entries. Create and manage notes attached to records, assign and complete tasks, and handle threaded comments. Configure the data model by defining custom objects and attributes. Access workspace member information, meeting data, and call recording transcripts. Subscribe to real-time webhook events for records, lists, notes, tasks, comments, and more.
Dataforseo
Retrieve practical DataForSEO API v3 data for SEO, SEM, ecommerce, business listings, Google Play apps, content analysis, and AI optimization. Supports Google/Bing/Yahoo/YouTube organic SERP live search, Google Ads keyword metrics, DataForSEO Labs keyword and domain intelligence, backlinks, OnPage audits and results, domain analytics, Google Shopping and Amazon Merchant tasks, Business Listings and Google Reviews, Google Play App Data tasks, and AI keyword, LLM mentions, and live LLM response benchmarking.
Item
Manage people, companies, and custom objects in item. Query shared views, inspect schema, batch upsert records, list users, and trigger webhook-based skills.
Technical notes for Piggy
Manage customer loyalty programs, rewards, gift cards, promotions, and vouchers. Create, update, and look up CRM contacts with custom attributes. Track loyalty credits and transactions, issue credit receptions, and manage credit balances. Create and redeem vouchers and promotions. Manage gift cards and prepaid balances. Configure rewards including digital and collectable types. Track orders, products, bookings, and visits. Manage shops, forms, automations, and portal sessions. Subscribe to webhooks for events including contact changes, credit receptions, voucher redemptions, gift card transactions, form submissions, and referrals.
Frequently asked questions
Common questions about connecting Piggy to AI agents with Metorial.
Can Metorial connect Piggy to AI agents?
Yes. Metorial connects AI agents to Piggy through a governed integration layer, so teams can use the provider while keeping access controlled and observable.Does the Piggy integration work with MCP?
Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.How does Metorial control access to Piggy?
Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.Can teams trace Piggy activity from agents?
Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.