Piggy

14 tools available

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

Connect Piggy to Definable to build sequences, sync segments, roll up daily campaign performance. Personas call Piggy's 14 tools directly from chat or scheduled flows. Connect it to a marketing persona to plan campaigns, score leads, and send personalised follow-ups.

Common workflows with Piggy

01

Lead-magnet sequence

  1. Form submission triggers an event
  2. Agent picks a sequence based on lead score
  3. Schedules and sends the first touchpoint
02

Daily campaign roll-up

  1. Pull yesterday's campaign metrics
  2. Generate a one-paragraph summary
  3. DM the team in Slack at 9am
03

Segment refresh

  1. Query the CRM for new active users
  2. Build/refresh the segment
  3. Push the updated audience to your sender

Piggy actions 14

Every Piggy action below is a callable tool any Definable persona can invoke.

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.

Create Contact Attribute

Tool to create a custom Contact Attribute. Use when you need to define new fields for contacts after initial setup.

Create Credit Reception

Tool to create a credit reception for a contact. Use when awarding credits to customers based on purchases or fixed amounts.

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.

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.

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.

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.

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.

List Forms

Tool to list all forms in the Piggy account. Use when you need to retrieve available forms for customer interactions.

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.

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.

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.

Update Bookings

Tool to update an existing booking in Piggy. Use when you need to modify booking details such as party size, status, or company name. Note: Shop and contact cannot be updated after creation.

Update Contact Identifiers

Tool to update a contact identifier in Piggy. Use when you need to modify the display name or active state of an existing contact identifier. Only the name and active properties can be updated; the identifier value itself cannot be changed.

Frequently asked questions

What can I automate with Piggy on Definable?

Anything Piggy exposes through its API. Common marketing automation workflows on Definable include build sequences, sync segments, roll up daily campaign performance. Personas can call any of the 14 Piggy tools directly, then chain the result into another integration without you writing code.

How does Piggy authentication work?

Piggy uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Piggy integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 14 Piggy tools. You only need a separate Piggy subscription if Piggy itself charges per seat or per API call.

Is using Piggy through Definable secure?

Every call from a persona to Piggy is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Piggy on Definable?

Sign up for Definable, open the integrations page, find Piggy, and connect via OAuth or API key. You can immediately attach Piggy to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Piggy actions does Definable expose?

Definable exposes all 14 Piggy actions as callable tools — including `Claim Anonymous Contact`, `Create Contact Attribute`, `Create Credit Reception`, plus 11 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Piggy?

Wire it up in minutes. No coding required.

← All integrations