Create Unique Invite Links

PollPe allows you to create personalized unique links for surveys using hidden parameters. This feature helps track and pre-fill survey responses efficiently.

🚀 Overview

Create unique invite links for each participant by passing hidden parameters like name, phone number, or custom values. These links can be distributed individually for:

• CRM integrations
• Campaign performance tracking
• Auto-filled fields in surveys
• Advanced analytics

---

📤 Create Unique Links – API Reference

🔗 Endpoint

POST https://core.pollpe.com/api/create-unique-links

🔐 Headers

Key	Value
Authorization	Bearer <YOUR_API_TOKEN>
Content-Type	application/json

NOTE:
You’ll need an API Token.

---

Request Body

{
  "surveyId": "XYZ000000",
  "properties": {
        "expiry": {
            "days": 2
        },
        "allowMultipleSubmission": false
    },
  "hidden": [
    {
      "hidden_parameter1": "value1",
      "hidden_parameter2": "value2",
      "hidden_parameter3": "value3"
    },
    {
      "hidden_parameter1": "value4",
      "hidden_parameter2": "value5",
      "hidden_parameter3": "value6"
    },
    ...
  ]
}

1. surveyId (string) - The unique ID of the target survey for which invite links are to be generated.
2. properties (object) - Configuration for the invite link behavior.

• expiry.days (number): Number of days after which the link will expire.
• allowMultipleSubmission (boolean): Whether a respondent can submit the survey more than once. Set to false to allow only one submission.

3. hidden (array of objects) - Each object represents a unique recipient’s hidden parameters. These values will be automatically embedded in the survey link and submitted with the response, without being visible to the user. You can include multiple key-value pairs for each respondent, such as IDs, source tags, or campaign info.

NOTE:
Use the same keys for your hidden parameters as you’ve set up in your form.

Response Object

{
"invites": [
    {
        "hidden_parameter1": "value1",
        "hidden_parameter2": "value2",
        "hidden_parameter3": "value3",
        "surveyLink": "https://poll.pe/e08229a2be8fdd3e6e14fe86b8bc970f"
    },
    {
        "hidden_parameter1": "value4",
        "hidden_parameter2": "value5",
        "hidden_parameter3": "value6",
        "surveyLink": "https://poll.pe/87e99d9339613a1299390eb76cdc83ce"
    },
    ...
],
"success": true
}

• surveyLink – (string) The unique invite link generated for each recipient, corresponding to their hidden data.

Example

Curl

curl --location --request POST 'https://core.pollpe.com/api/create-unique-links' \
--header 'Authorization: Bearer <YOUR_API_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "surveyId": "XYZ000000",
  "properties": {
        "expiry": {
            "days": 2
        },
        "allowMultipleSubmission": false
    },
  "hidden": [
    {
      "hidden_parameter1": "value1",
      "hidden_parameter2": "value2",
      "hidden_parameter3": "value3"
    },
    {
      "hidden_parameter1": "value4",
      "hidden_parameter2": "value5",
      "hidden_parameter3": "value6"
    },
    ...
  ]
}'

Javascript

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer <YOUR_API_TOKEN>");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "surveyId": "XYZ000000",
  "properties": {
        "expiry": {
            "days": 2
        },
        "allowMultipleSubmission": false
    },
  "hidden": [
    {
      "hidden_parameter1": "value1",
      "hidden_parameter2": "value2",
      "hidden_parameter3": "value3"
    },
    {
      "hidden_parameter1": "value4",
      "hidden_parameter2": "value5",
      "hidden_parameter3": "value6"
    },
    ...
  ]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://core.pollpe.com/api/create-unique-links", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Python

import http.client
import json

conn = http.client.HTTPSConnection("https://core.pollpe.com")
payload = json.dumps({
  "surveyId": "XYZ000000",
  "properties": {
        "expiry": {
            "days": 2
        },
        "allowMultipleSubmission": false
    },
  "hidden": [
    {
      "hidden_parameter1": "value1",
      "hidden_parameter2": "value2",
      "hidden_parameter3": "value3"
    },
    {
      "hidden_parameter1": "value4",
      "hidden_parameter2": "value5",
      "hidden_parameter3": "value6"
    },
    ...
  ]
})
headers = {
  'Authorization': 'Bearer <YOUR_API_TOKEN>',
  'Content-Type': 'application/json'
}
conn.request("POST", "/api/create-unique-links", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))