Integrating Trustpilot with Yespo

Collecting customer reviews is essential for building trust and social proof. With the Yespo–Trustpilot integration, you can automate inviting customers to leave a review after key events. This integration helps you:

• Increase the number of verified reviews.
• Save time by automating manual outreach.
• Trigger invitations at the optimal time based on user behavior.
• Maintain consistent communication via localized, branded review emails.

How Integration Works

1. The customer performs an action that triggers a workflow in Yespo.
2. Webhook in workflow sends a request to the Trustpilot API.
3. Trustpilot API processes the request and launches the email invitation.
4. The customer receives an email asking for feedback.

Integration Requirements

To enable automatic review invitations via Yespo and Trustpilot, you’ll need the following:

1. Trustpilot Business Account: Free plans do not support API-based invitation sending.
2. Access to Trustpilot Invitation API: See Trustpilot documentation.
3. Retrieve the following credentials:
   • Client ID
   • Client Secret
   • access_token
   • businessUnitId

Creating a Workflow in Yespo

To send invitations automatically, create a workflow in Yespo that uses the Webhook block to call Trustpilot's API.

Steps:

1. Log in to your Yespo account.
2. Navigate to Automation → Workflows → New workflow.

3. Add a Webhook block to your workflow and click Select webhook.

4. Click New webhook.

5. Set up webhook:
   • Enter webhook’s name (and, optionally, description)
   • Method: POST
   • URL: https://invitations-api.trustpilot.com/v1/private/business-units/YOUR_BUSINESS_UNIT_ID/invitations
   • Pass parameters in headers:
     • Authorization: Bearer YOUR_ACCESS_TOKEN
     • Content-Type: application/json
   • Pass JSON in the request body — example:

{  
  "consumerEmail": "$data.get('email')",  
  "referenceId": "$data.get('orderId')",  
  "locale": "$data.get(locale)",  
  "senderEmail": "[email protected]"  
}

📘

Note

The values inside $data.get(...) must be passed in the event that triggers the workflow.

6. Click Done.

More on using webhooks in workflows >

Required Fields for the API Request

Trustpilot’s documentation provides the following required fields:

Passing Data via Events in Yespo

To make request fields available in a workflow, pass them as parameters of the event that triggers this workflow.
Include all necessary fields like email, orderId, and locale. These values will be accessible in the Webhook block using Velocity expressions:

• $data.get('fieldName')

For example:

• $data.get('email') → extracts the customer's email
• $data.get('orderId') → extracts the order ID

📘

Note

You can use the backend API or the iOS and Android SDKs to send events with dynamic data