# Piggy AI integration on Definable

> Piggy offers cashback and loyalty program integrations for online stores, letting users earn points or discounts and encouraging repeat purchases

## What this connects

Piggy offers cashback and loyalty program integrations for online stores, letting users earn points or discounts and encouraging repeat purchases

Vendor: https://www.piggy.eu/

## Tools available

**14** tools available. First 12:

- `PIGGY_CLAIM_ANONYMOUS_CONTACT` — Claim Anonymous Contact — Tool to claim an anonymous contact by associating it with a real email address. Use when converting an anonymous contact (with a fictional email) into a verified contact with a real email address.
- `PIGGY_CREATE_CONTACT_ATTRIBUTE` — Create Contact Attribute — Tool to create a custom Contact Attribute. Use when you need to define new fields for contacts after initial setup.
- `PIGGY_CREATE_CREDIT_RECEPTION` — Create Credit Reception — Tool to create a credit reception for a contact. Use when awarding credits to customers based on purchases or fixed amounts.
- `PIGGY_CREATE_VOUCHERS_BATCH` — Create Vouchers Batch — Tool to create a batch of vouchers for a promotion. Use when you need to generate multiple vouchers at once for a specific promotion. Batch processing is asynchronous and returns a PENDING status initially.
- `PIGGY_FIND_OR_CREATE_PRODUCTS` — Find or Create Products — Tool to find an existing product by external_identifier or create a new one if it doesn't exist. Use when you need to ensure a product exists in Piggy's system for loyalty programs or rewards.
- `PIGGY_FIND_VOUCHER_BY_CODE` — Find Voucher By Code — Tool to find a voucher by its unique code. Use when you need to retrieve voucher details, check redemption status, or validate a voucher code.
- `PIGGY_GET_CONTACT_AUTH_TOKEN` — Get Contact Auth Token — Tool to get an auth token for a Contact. Use after obtaining a Contact UUID and needing to verify identity for secure operations.
- `PIGGY_GET_CONTACTS_CREDIT_BALANCE` — Get Contact's Credit Balance — Tool to get a Contact's credit balance. Use when you need to check a contact's current credit balance before processing rewards or promotions.
- `PIGGY_LIST_FORMS` — List Forms — Tool to list all forms in the Piggy account. Use when you need to retrieve available forms for customer interactions.
- `PIGGY_LIST_PERKS` — List Perks — Tool to list all available perks in Piggy. Use when you need to retrieve the catalog of perks that can be associated with contacts or transactions.
- `PIGGY_MERGE_CONTACTS` — Merge Contacts — Merges a source contact into a destination contact in Piggy's CRM. The source contact's data (attributes, balances, transactions) is transferred to the destination contact, and the source contact is removed. This operation is irreversible and processed asynchronously via a job queue. Use this when consolidating duplicate customer records.
- `PIGGY_SEND_CONTACT_VERIFICATION_EMAIL` — Send Contact Verification Email — Send a verification email to a Piggy contact for identity verification. The contact must exist in the system with a configured Contacts Portal. Returns success message with email sent confirmation. Use this when implementing email-based authentication workflows or when contacts need to verify their email address to access the Contacts Portal.

## Auth

Auth schemes: `API_KEY`.

## How agents use Piggy

Inside a Definable workflow, Piggy is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Piggy** — the Researcher (GPT-5.5) pulls context from Piggy (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Piggy** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Piggy (create record, post message, draft email).
- **Designer / Engineer → Distributor → Piggy** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Piggy (attach file, open PR comment, post status).

The Verifier checks every Piggy call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- marketing automation — https://definable.ai/apps/category/marketing-automation/
- ecommerce — https://definable.ai/apps/category/ecommerce/

## Related

- HTML page: https://definable.ai/apps/piggy/
- Same category (marketing automation): https://definable.ai/apps/category/marketing-automation/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt