---
title: Customizing your Embedded PerksWallet Integration
slug: customizing-your-embedded-perkswallet-integration
icon: 🧰
docTags:
createdAt: 2025-04-11T00:15:15.904Z
---
:::hint{type="info"}
**Who is this for:** Developers who have completed an Embedded PerksWallet integration and want to add real-time event tracking and custom UI text.
**Outcome:** Configure webhook endpoints to receive offer saved and removed events, and customize CTA button labels and confirmation messages in the wallet experience.
:::
# Overview
This document outlines how to customize your **Embedded PerksWallet** integration with MomentScience. Customization options include CTA button labels, confirmation messages, and webhooks for tracking user actions in real time.
:::hint{type="warning"}
**Note:** These customization options apply to **Embedded PerksWallet** integrations only. If you're using [Integrating with Hosted PerksWallet](docId:0zfIUnAhNWI7qljCQQ052), navigate to that page to learn more about the wallet experience and available customization options.
:::
# Webhook Integration
You can configure a webhook URL to receive real-time updates about key user actions. This allows your system to track offers saved or removed as they happen, enabling better user engagement and more timely interactions.
## Available Webhook Events
MomentScience will send a **POST** or **GET** request to your configured webhook URL whenever the following user actions occur:
1. **Offer Saved: **Triggered when a user saves an offer to their wallet.
2. **Offer Removed from Saved: **Triggered when a user removes an offer from their wallet.
:::hint{type="info"}
You can choose whether your webhook endpoint accepts `POST`or `GET` requests based on your system's architecture. The payload remains the same for both methods.
:::
## Webhook Payload Structure
Each event payload contains the following fields:
| **Field** | **Description** |
| ------------------- | ---------------------------------------------------------- |
| `event` | Type of event: `offer_saved`or `offer_removed`. |
| `pub_user_id` | Your internal user identifier. |
| `offer_id` | Unique identifier of the offer. |
| `advertiser_name` | Name of the advertiser. |
| `headline` | Full headline for the offer. |
| `short_headline` | Shortened version of the headline. |
| `description` | Full offer description. |
| `short_description` | Shortened offer description. |
| `mini_text` | Supporting mini text for the offer. |
| `click_url` | URL users are directed to when they engage with the offer. |
| `image` | URL to the offer creative. |
| `cta_yes` | Primary call-to-action label (e.g., "Yes Please"). |
| `cta_no` | Secondary call-to-action label (e.g., "No Thanks"). |
| `tnc` | Offer terms and conditions or legal disclaimer. |
| `timestamp` | ISO 8601 timestamp when the event occurred. |
## Setting Up Your Webhook
You can easily set up your webhook directly from the dashboard by following these steps:
1. **Navigate to the Configuration Page:** Go to your [account settings](https://momentscience.com/account/settings/behavior).
2. **Access Postbacks and Webhooks: **Scroll down to the Postbacks and Webhooks section and click the Manage button.
3. **Select the Webhook Tab for PerksWallet: **Navigate to the Webhook for PerksWallet tab.
4. **Choose HTTP Method: **Select the appropriate HTTP method (either `GET`or `POST`).
5. **Provide the Webhook URL: **Enter the URL where you want to receive the webhook notifications.
6. **Save the Configuration:** Click the Save button to confirm your webhook settings.
7. **Test the Webhook (Optional): **If you want to test your webhook setup, click the **Test Endpoint** button to send dummy data and verify the connection.
:::Iframe{code=""}
:::
***
# CTA Button Customization
You can customize the CTA (Call to Action) label and the confirmation message that appears after a user saves an offer. This allows you to tailor the experience to better match your product’s tone and user expectations.
**Default Behavior**
- **CTA Button Label:** "Save For Later"
- **Confirmation Message:** "Saved"
For both Moments Solution and Perkswall Solution, you can override these default texts through their respective integration settings.
## Moments
To update the CTA text and confirmation message:
1. Log in to your [MomentScience Dashboard.](https://app.momentscience.com/)
2. Navigate to the [Moments Integration Page](https://app.momentscience.com/account/integration/customize?platform=js-sdk).
3. Select the **Theme Settings** tab.
4. Make sure that **"Show PerksWallet CTA" **is **enabled.**
5. Scroll to the field labeled **PerksWallet CTA**.
- Update the CTA button label (e.g., change "Save For Later" to "Add to Wallet").
6. Below that, update the **Saved Offer Text** field.
- This text appears after the user clicks the button (e.g., change "Saved" to "Offer Added to Wallet").
:::Iframe{code=""}
:::
## Perkswall
To update the CTA text and confirmation message:
1. Log in to your [MomentScience Dashboard.](https://app.momentscience.com/)
2. Navigate to the [Perkswall Integration Page](https://staging.momentscience.com/account/integration/perkswall).
3. Select the **Theme Settings** tab.
4. Make sure that **"Show PerksWallet CTA" **is **enabled.**
5. Scroll to the field labeled **PerksWallet CTA Text**.
1. Update the CTA button label (e.g., change "Save For Later" to "Add to Wallet").
6. Below that, update the **Saved Offer Text** field.
1. This text appears after the user clicks the button (e.g., change "Saved" to "Offer Added to Wallet").
:::Iframe{code=""}
:::
***
📢 If you're running into any issues while going through the integration process, feel free to contact us at [help@momentscience.com](mailto\:help@momentscience.com)