Send a Survey on your side

This use case shows how to get a Fullwhere survey link for a specific customer and purchase, so you can handle the survey sending on your side, without triggering the automatic sending process.

1. Import the customer

Start by importing a customer in Fullwhere. This entity contains the customer’s basic information (name, email, etc.) and will be used to link future purchases and surveys to the right customer.

API Reference: POST partners/customers

---

2. Import the purchase

Next, import a purchase linked to this customer. The purchase includes transaction details (amount, date, etc.) and must be linked to the customer you just imported with the customerId field.

API Reference: POST partners/purchases

When creating the purchase, set the query parameter allowSurvey to false:

"allowSurvey": false

In this case, Fullwhere will not send the survey automatically. Instead, Fullwhere makes the survey available for this purchase, allowing you to retrieve the survey link and send it to the customer through your own communication channels (email, SMS, etc.).

---

3. Retrieve the survey link

Once you have imported the customer and the purchase, you can retrieve the unique survey URL by generating a Survey Tracker. You can then distribute this link directly to the customer from your own system.

API Reference: POST /partners/survey-tracker/generate

---

This approach gives you full control over how and when the survey is delivered to the customer. When the customer completes the survey, all responses are automatically synchronized and available within Fullwhere.