How Do I Submit a Review Using the Feedspace API?

With the Feedspace REST API, you can programmatically submit a testimonial on behalf of a customer. This is useful for automating review collection immediately after a purchase is completed, an onboarding step is finished, or any milestone event in your application.

Before You Begin

API access requires a Professional or Business plan in Feedspace. You will also need:

• Your Feedspace API Key (found in Automation > API tab)
• The form ID of the Feedspace form you want to submit the review to
• A server-side environment to make API calls (never call the API from client-side code)

Step 1: Get Your API Key

1. Log in to your Feedspace account.
2. In the left sidebar, click Automation.
3. Select the API tab at the top of the Automation page.
4. If you have not generated keys yet, click Generate. Then click the copy icon next to your API Key to copy it.

Store this key in an environment variable on your server. Never expose it in client-side or publicly accessible code.

Step 2: Find Your Form ID

Each Feedspace review form has a unique ID. To find it:

1. In your Feedspace dashboard, open the Forms section from the left sidebar.
2. Click on the form you want to submit reviews to.
3. The form ID appears in the URL of the form settings page. Copy the numeric or alphanumeric ID shown there.

You will pass this value as the form_id field in your API request body.

Step 3: Send the POST Request

To submit a review, send a POST request to the Feedspace submit review endpoint. Include your API Key as a Bearer token in the Authorization header and send the reviewer details as a JSON body.

Endpoint

POST https://api.feedspace.io/v1/testimonials

Required Request Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body Fields

• form_id: The ID of the Feedspace form to submit the review to
• name: The reviewer’s full name
• email: The reviewer’s email address
• rating: Numeric rating (typically 1 to 5)
• review: The text content of the testimonial

Sample cURL Command

curl -X POST "https://api.feedspace.io/v1/testimonials" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "form_id": "YOUR_FORM_ID",
    "name": "Jane Smith",
    "email": "jane.smith@example.com",
    "rating": 5,
    "review": "Feedspace made it incredibly easy to collect and display customer testimonials. Highly recommended!"
  }'

Replace YOUR_API_KEY with your actual API Key and YOUR_FORM_ID with the ID of your target form.

What Happens After Submission

Once your request is accepted, the submitted review appears in the Feedspace Feedbox for that form. From there, you can:

• Moderate the review before it goes live, approving or rejecting it as needed
• Reply to the reviewer directly from the Feedbox
• Mark it as a favourite or add labels for organisation
• Include it in Creative Space designs or embed widgets once published

Submitted reviews are not automatically published. Moderation keeps your testimonial library accurate and trustworthy.

Common Use Cases

• Post-purchase review collection: Trigger the API call from your order fulfilment webhook, automatically requesting a testimonial when an order is marked complete.
• Onboarding completion: Submit a review request after a customer finishes your product onboarding flow or tutorial sequence.
• CRM integration: Pull customer details from your CRM and submit pre-populated review data when specific lifecycle milestones are reached.

Troubleshooting

• 401 Unauthorized: Your API Key is missing, incorrect, or has been regenerated. Return to Automation > API tab to copy the current key.
• 422 Unprocessable Entity: A required field is missing or has an invalid value. Check that form_id, name, email, rating, and review are all present in the request body.
• Review not appearing in Feedbox: Confirm the form_id matches the correct form. Each form has its own Feedbox, so submissions to one form will not appear in another form’s inbox.