Punchh: SFTP segmentation integration (legacy)

You can connect Attentive with the loyalty platform, Punchh, to upload a segmentation list to Attentive to send SMS campaigns to your loyal customers. To connect your Punchh segmentation list with Attentive, you must work with our White Glove team (whiteglove@attentivemobile.com) at Attentive to set up an SFTP folder. Then, contact your Punchh account representative to enable the integration. Once the integration is enabled, a CSV file that includes the Punchh segmentation list can be placed in the assigned SFTP folder to connect to Attentive. These files are processed every 24 hours, ensuring that your Punchh segmentation list in Attentive is up-to-date.

If you'd like to pass back a subscriber’s email address and phone number to your Punchh account, see the Punchh: postback and messaging integration article.

Note the following:

  • A subscriber is identified as a phone number or email address.
  • If a phone number provided does not match an active and opted-in subscriber in Attentive’s database, it is ignored and not added to the platform.
  • Once this integration is configured, your Punchh segmentation list appears in Attentive.

File format

View the following table to understand how the CSV file must be formatted:

Description Example
UserId The unique identifier in Punchh for the subscriber. 123456XXX
Email The email address of the subscriber. email1@email.com
Marketing PN Subscription This field indicates whether the user is subscribed or unsubscribed.

When subscribed, the user is placed in the Marketing PN Subscription segmentation list.

When unsubscribed, the user is not placed in the Marketing PN Subscription segmentation list.




Phone number The phone number of the subscriber.

Note the following:

  • Phone numbers should be formatted as: XXX-XXX-XXXX or XXXXXXXXXX
  • Country codes may be included.
The following list outlines accepted values:
  • 1234567890
  • 123-456-7890
  • 1123-456-7890
  • 11234567890
Guest Type The subscriber is segmented into a Guest Type (either Loyalty or eClub) in Punchh. Loyalty



The following is an example of what your CSV file should resemble:

UserId Email Marketing PN Subscriber Phone Guest Type
654321XXX email1@email.com unsubscribed 1234567890 Loyalty
123456XXX email2@email.com subscribed 234-567-8901 Loyalty
012345XXX email3@email.com subscribed 1123-456-7890 Loyalty
112233XXX email4@email.com subscribed 4567890123​ eClub