Rivo

Creates Points Event using Rivo. Requires source and applied_at and skip_email and external_note and internal_note and points_amount and credits_amount and customer_email and custom_action_name. Returns confirmation of creation, including the new record’s ID and details.

Retrieves customer loyalty program information from Rivo using their email address.

This integration connects to Rivo’s loyalty program platform to fetch a customer’s complete profile information, including their loyalty status, points balance, VIP tier, purchase history, and referral details. This allows support teams to quickly access customer loyalty data to assist with rewards inquiries, tier status questions, or account troubleshooting.

Parameters

• customer_email (String (email)): The email address of the customer whose loyalty information you want to retrieve. Example: “sarah.martinez@example.com”.

Output

Returns a comprehensive customer loyalty profile containing customer_id, email, first_name, last_name, loyalty_status (member/guest), referral_code, vip_tier, points_tally (current points balance), credits_tally (store credit balance), orders_count, total_spent, customer_shopify_tags (array of tags), points_expire_at (expiration date), dob (date of birth), and lifetime_earnings_tally.

Example Output:

{
  "customer": {
    "customer_id": 7294851236742,
    "email": "sarah.martinez@example.com",
    "first_name": "Sarah",
    "last_name": "Martinez",
    "loyalty_status": "member",
    "referral_code": "kL9mR4xP8vN2sQ7tY",
    "customer_dob": null,
    "customer_shopify_tags": ["premium-customer", "active-user", "status-member"],
    "points_expire_at": null,
    "vip_tier": null,
    "orders_count": 5,
    "total_spent": 423.78,
    "points_tally": 150,
    "dob": null,
    "dob_last_updated_at": null,
    "lifetime_earnings_tally": null,
    "credits_tally": "25.0"
  }
}

Cancels an active Rivo loyalty membership for a customer using their email address.

This integration cancels an active membership in Rivo’s loyalty program for a specific customer. When executed, it initiates the cancellation process and typically follows an “end of period” policy, meaning the membership benefits continue until the current billing cycle ends. This is useful for customer service teams who need to process membership cancellations on behalf of customers.

Parameters

• customer_email (String (email)): The email address of the customer whose Rivo membership you want to cancel. This parameter is required. Example: “sarah.mitchell@example.com”.

Output

Returns a membership cancellation object containing the cancellation status, confirmation message, customer ID, cancellation policy details, and a unique cancellation request ID for tracking purposes. The status indicates the current state of the cancellation, message provides a human-readable confirmation, customer_id is the internal Rivo customer identifier, cancellation_policy shows when the cancellation takes effect, and cancellation_request_id provides a unique reference number.

Example Output:

{
  "data": {
    "type": "membership_cancellation",
    "attributes": {
      "status": "pending",
      "message": "Membership cancellation initiated",
      "customer_id": 7429856312847,
      "cancellation_policy": "end_of_period",
      "cancellation_request_id": 84592
    }
  }
}