Introduction

Punchh is a loyalty and engagement platform that empowers brands to deliver omnichannel customer loyalty programs both in-store and online.

MoEngage × Punchh

Using MoEngage and Punchh together, you can sync data between the two platforms to empower your loyalty and coupon workflows. With this integration, you can:

Forward loyalty data from Punchh to MoEngage in real-time
Capture new users inside MoEngage and send them to Punchh to create personalized loyalty programs for them
Display dynamic coupon codes generated on Punchh inside MoEngage Campaigns

Integration

Access to your Punchh Dashboard.
Access to your Punchh APIs and Webhooks Manager. Contact your Punchh representative if you do not have access to Punchh Webhook Manager.
Access to your MoEngage Dashboard.

A. Forward events from Punchh to MoEngage

Step 1: Add external_source_id to Punchh users

Before you begin the integration, ensure you have set the external_source_id field when you create new users inside Punchh. This will act as the common identifier between the two platforms and will be synced to the ID field of MoEngage user profiles. Punchh offers several endpoints for updating your users’ external_source_ids. The Punchh help docs explain how to set them up for new and existing users.

Step 2: Get your MoEngage endpoint

To get a dedicated endpoint for your integration, please contact the MoEngage Support team. In your request, you must specify the common identifier used to link user profiles between MoEngage and the partner platform.

Step 3: Set up your endpoint as a webhook in Punchh

If you already have access to the Webhooks Manager,

On your Punchh Dashboard’s Left Navigation >> Webhook Manager.\
In the Webhooks section, an admin needs to click the Base URL button to set up the base URL and name. This base URL will be displayed while setting up the webhook. Your Base URL will depend on your MoEngage Data Center:

Data Center Region	Base URL
DC-01	https://api-01.moengage.com
DC-02	https://api-02.moengage.com
DC-03	https://api-03.moengage.com
DC-04	https://api-04.moengage.com

In the Webhooks section, create a new webhook by clicking the Create Webhook button:

Field	Description
Name and Description	Enter an identifiable name and description for this Webhook, example, “MoEngage”.
Base URL	Select the MoEngage Base URL you created above.
Webhook Endpoint	Enter the rest of the MoEngage Endpoint provided to you by your Customer Success Manager. Example: `/v1/partner/punchh/events/?configName=xxxx`
Authentication	Select “Basic” as the authentication method.
Username	Enter the the Workspace ID of your MoEngage Workspace. It is available at Settings -> Account -> APIs -> Workspace ID. The Data API ID and the Workspace ID of your MoEngage account are the same.
Password	Enter the Secret Key of your MoEngage Workspace. Secret key is the Data API key of your MoEngage account, which is available at Settings -> Account -> APIs -> API keys -> Data API settings.
Events Selection	Select the events you want to forward to MoEngage.

Click the Submit button to save it. In case of any issue, it will display an error message.
If verification is completed during creation, the webhook will be ready to receive the subscribed events with “Active” status. If verification is not successful, the status will remain “Inactive” and no data will be pushed to that webhook.
From the webhooks list, you can select another operation via the ellipsis button in the Actions column to test with some dummy event samples. You can also edit or delete webhooks from here and see logs specific to the selected webhook.

Events available to export to MoEngage

Users
Loyalty check-ins
Gift check-ins
Redemptions
Rewards
Redeemables
Marketing notifications
Transactional notifications
Coupons

An updated list of events that can be exported is found here.

Step 4: Find your events in MoEngage

Below is the meta data that is added to each of the events coming from Punchh:

MoEngage Event Attribute	Punchh Value	Description
Event name	`event_name`	Name of the event such as user, check-ins, redemption, etc.
`event_type`	`event_type`	Type of the event (e.g., gift or loyalty for check-ins, etc.)
Event time	`timestamp`	UTC epoch (in milliseconds) when the message is created
`business_id`	`business_id`	Business identification at the Punchh platform
`business_uuid`	`business_uuid`	UUID of the business configured in the Punchh platform. This code is used for POS integration.
`business_slug`	`business_slug`	Unique identifier or label for a business in the URL set up for iFrame on the Punchh side. The slug is configured in the Punchh platform. Contact your Punchh representative to update this Punchh platform configuration.
`action`	`action`	Operation associated with the event (e.g., create/update/delete for user, POS/console/online for check-ins, etc.)
`user`	`user`	The user properties associated with the Punchh user who performed this action.

Once the events are in MoEngage, you can create segments using MoEngage’s powerful Segmentation capabilities and perform Analytics to gain even deeper actional insights.

B. Create users in Punchh from MoEngage

Create MoEngage campaign to connect to Punchh Create users API

To create a connector campaign on MoEngage:

Navigate to Create Campaign > Connectors > Custom and choose the delivery type most suitable to your needs

On step 2 of the campaign, connect to the Punchh Create Users API. First, you need an OAuth App setup in the Punchh Dashboard. Refer to the detailed Punchh document.

Method: POST
URL: https://server_name_goes_here.punchh.com/api/auth/customers.json
Headers:

Key	Description	Default value
Accept	Advertises which content types the client is able to understand	application/json
Content-Type	Set this header to application/json.	application/json
User-Agent	For details, see User Agent.	Punchh/OnlineOrder/1.0/Web/BrowserVersion/OS_Type
x-pch-digest	The signature for the API call	—

Body:

{  
  "user": {  
    "email": "{{UserAttribute['email']}}",  
    "first_name": "{{UserAttribute['First Name']}}",  
    "last_name": "{{UserAttribute['Last Name']}}",  
    "password": "{{UserAttribute['Password']}}",  
    "birthday": "{{UserAttribute['Birthday']}}",  
    "anniversary": "{{UserAttribute['Anniversary']}}",  
    "phone": "{{UserAttribute['Mobile']}}",  
    "terms_and_conditions": true,  
    "send_compliance_sms": true,  
    "external_source": "{{UserAttribute['external_source']}}",  
    "external_source_id": "{{UserAttribute['customer_id']}}",  
    "signup_channel": "WebEmail",  
    "age_verified_status": true  
  },  
  "client": "CLIENT_GOES_HERE"  
}

Here, external_source and external_source_id are optional fields.
In the above example, customer_id is a unique identifier in MoEngage and hence being passed against external_source_id. If there is any other unique user identifier that you are already using, you can pass that instead of customer_id.

Preview your request

At this point, your campaign should be ready to test and send. You can also test your connector configuration using the Test functionality available in Step 2 of Create Connector Campaign.

You can go ahead and Publish the campaign.

​Introduction

​MoEngage × Punchh

​Integration

​A. Forward events from Punchh to MoEngage

​Step 1: Add external_source_id to Punchh users

​Step 2: Get your MoEngage endpoint

​Step 3: Set up your endpoint as a webhook in Punchh

​Events available to export to MoEngage

​Step 4: Find your events in MoEngage

​B. Create users in Punchh from MoEngage

​Create MoEngage campaign to connect to Punchh Create users API

​Preview your request

Introduction

MoEngage × Punchh

Integration

A. Forward events from Punchh to MoEngage

Step 1: Add external_source_id to Punchh users

Step 2: Get your MoEngage endpoint

Step 3: Set up your endpoint as a webhook in Punchh

Events available to export to MoEngage

Step 4: Find your events in MoEngage

B. Create users in Punchh from MoEngage

Create MoEngage campaign to connect to Punchh Create users API

Preview your request