Skip to main content

Survey Links

A survey link is a URL that directs customers to a survey form.

info

Common mediums for sharing survey links include:

  • QR Codes: Generate a QR code that links to the survey, allowing customers to scan it with their mobile devices.
  • Social Media: Post the link on platforms like Instagram, Facebook, or Twitter to reach a wider audience.
  • POS Integration: Some POS systems allow you to send Harlyy survey links directly to customers after a transaction.

You can also manually create survey links using either of the following formats:

https://www.harlyy.com/surveys/<business_id>/<survey_id>
https://www.harlyy.com/surveys/<business_id>/<survey_id>/<location_id>

Preview links can be created, which are useful for testing before sharing with customers:

https://www.harlyy.com/surveys/<business_id>/<survey_id>/preview

Replace <business_id>, <survey_id>, and <location_id> with the appropriate IDs from your Harlyy account.

Harlyy links also support powerful query parameters which make it easier for partners to integrate with Harlyy surveys.

text parameter​

The text parameter allows you to pre-fill the text field in a contact-step in the survey. This can be helpful in many use cases, for example, many of our POS partners use this to inject and order number in order to track submissions back to the order.

https://www.harlyy.com/surveys/<business_id>/<survey_id>?text=<text>
https://www.harlyy.com/surveys/<business_id>/<survey_id>/<location_id>?text=<text>

location:metadata parameter​

The location:metadata parameter allows you to infer the location that a survey link is being used for, based on an internal identifier that you can pass in the URL. In order to use this, a business' locations must have a metadata field setup with a <key>.<value> pair that matches the value you pass in the URL.

https://www.harlyy.com/surveys/<business_id>/<survey_id>?location:metadata=<key>.<value>
https://www.harlyy.com/surveys/<business_id>/<survey_id>/<location_id>?location:metadata=<key>.<value> (will default to <location_id> if no location is found)

For example, if you have an internal identifier for a location called store_id with a value of 12345, you can pass this in the URL like so:

https://www.harlyy.com/surveys/<business_id>/<survey_id>?location:metadata=store_id.12345

and setup each location's metadata in the Harlyy dashboard like this:

Location Metadata Example

location:labels parameter​

The location:labels parameter allows you to filter or infer the location based on one or more label IDs assigned to your locations in Harlyy. Pass a comma-separated list of label IDs:

https://www.harlyy.com/surveys/<business_id>/<survey_id>?location:labels=<label_id1>,<label_id2>

You can find a label's ID from the Labels page — press the three dots next to a label and click Copy ID.

Locations are matched using AND logic — only locations that have all of the provided labels are considered.

The behavior depends on how many locations match:

MatchesBehavior
Exactly 1Location is silently auto-assigned; the customer never sees the location step.
2 or moreThe location step shows only the matching locations, without the city dropdown.
0Falls back to the standard city-based location selection flow.

For example, to surface only locations tagged with two specific labels:

https://www.harlyy.com/surveys/<business_id>/<survey_id>?location:labels=lb_6627f1a2e4b0d3c1a2b3c4d5,lb_6627f1a2e4b0d3c1a2b3c4d6