Third-party integrations

Integrating via query string parameters

Introduction

A simple way to integrate your site with Feature Upvote is by using HTML GET requests with query string parameters. You can:

  • prefill the ‘Add Suggestion’ form.
  • set a user’s name and email for any actions they might do while browsing your feedback board.

How to create suggestions via query string parameters

The URL is: https://yourproductcode.featureupvote.com/suggestions/add

If you are using a custom domain name, then you can also use: https://customdomainname/suggestions/add

Note that the suggestion is not created until you explicitly submit the ‘Add suggestion’ form. These fields simply prepopulate the form with data of your choice.

Valid query string parameters are:

  • title
  • description
  • name - the name of the person making the suggestion
  • email - the email of the person making the suggestion

All fields are optional. Any other fields are ignored. All leading and trailing whitespace is trimmed. If necessary, the text will be truncated to fit the form’s maximum field lengths.

Standard URL parameter encoding must be used.

Example:

https://yourproductcode.featureupvote.com/suggestions/add
?title=Add+PDF+Export&name=John+Smith&email=john@example.com

How to set a user’s name and email via query string parameters

This approach is available when you send users to your board’s home (the list of all suggestions).

The URL is: https://yourproductcode.featureupvote.com/

If you are using a custom domain name, then you can also use: https://customdomainname/

Valid query string parameters are:

  • name - the name of the person you are sending to your board
  • email - the email of the person you are sending to your board

Either field is optional. All leading and trailing whitespace is trimmed.

Standard URL parameter encoding must be used.

Example:

https://yourproductcode.featureupvote.com/?name=John+Smith
&email=john@example.com

Upon landing on your feature board, the name and email parameters are removed from the query string and internally stored for the duration of the user’s browsing session.

These parameters are used to populate the name and email fields when a user adds a new suggestion, adds a comment, and votes on an existing suggestion.

Need more help with this?

Contact us here