# All Audio Reviews Source: https://docs.feedspace.io/api-reference/AudioReviews/all-audio-reviews GET /feeds Get a paginated list of feeds across the workspace. Supports optional filters: `filter[search]`, `filter[feed-types][]`, `filter[favourite]`, `filter[review_with_comment]`, `filter[sentiments][]`, `filter[star-rating][]`, `filter[feed-forms][]`, `filter[review-labels][]`, and `filter[imported-froms][]`. All filters are optional; filters of different types are AND-combined, while values within a single filter array are OR-combined. Get a paginated list of all audio feeds received. ## Query Parameters * `filter[feed-types][]` (required): Set to `"audio"` to filter audio feeds * `page` (optional): Page number for pagination (default: 1) ## Example Request ```bash theme={null} GET /feeds?filter[feed-types][]=audio&page=1 ``` ## Response Returns a paginated list of audio feeds with feed fields, question answers, and other details. # Update Audio Review Source: https://docs.feedspace.io/api-reference/AudioReviews/edit-audio-review POST /feeds/audio/{audio_feed_id} Edit a specific audio review. # Single Audio Review Source: https://docs.feedspace.io/api-reference/AudioReviews/single-audio-review GET /feeds/audio/{audio_feed_id} Get details of a specific audio feed based on audio feed ID. # Delete Audio Review Source: https://docs.feedspace.io/api-reference/AudioReviews/soft-delete DELETE /feeds/audio/{audio_feed_id} Delete a specific audio review from the list. # List All Feeds Source: https://docs.feedspace.io/api-reference/Feeds/list-feeds GET /feeds Get a paginated list of feeds across the workspace. Supports optional filters: `filter[search]`, `filter[feed-types][]`, `filter[favourite]`, `filter[review_with_comment]`, `filter[sentiments][]`, `filter[star-rating][]`, `filter[feed-forms][]`, `filter[review-labels][]`, and `filter[imported-froms][]`. All filters are optional; filters of different types are AND-combined, while values within a single filter array are OR-combined. Get a paginated list of all feeds across the workspace — text, audio, video, and social — in a single response. Use the query parameters below to narrow the results. ## Filters All filters are optional. Filters of **different** types are combined with **AND**; values within a **single** filter array are combined with **OR**. Supported query filters: * `filter[search]` — free-text keyword search across reviewer name and review text * `filter[feed-types][]` — feed type (`video`, `audio`, `text`, `social`) * `filter[favourite]` — favourited feeds only (`true`) * `filter[review_with_comment]` — feeds with a non-empty comment (`true`) * `filter[sentiments][]` — AI-detected sentiment (`positive`, `negative`, `neutral`) * `filter[star-rating][]` — star rating (`1`–`5`) * `filter[feed-forms][]` — review form ID(s) * `filter[review-labels][]` — review label ID(s) * `filter[imported-froms][]` — import source platform ID(s) ### `filter[search]` Free-text keyword search. Matches the keyword as a **case-insensitive substring** against the reviewer's name and the review text/comment, returning only feeds that contain it. Multi-word strings are matched literally — `excellent service` returns reviews containing that exact run of text. Encode the space as `%20` or `+`. Use `filter[search]`. The bare `search` query parameter has **no effect** on this endpoint and is silently ignored — no error is returned. A keyword that matches nothing returns an **empty** result, so you can rely on this filter for client-side search without extra validation. This differs from `filter[feed-types][]` and `filter[sentiments][]`, which silently drop *unrecognised values* and return the full unfiltered list. ```bash Single word theme={null} curl -g -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[search]=Dewalt' ``` ```bash Multi-word theme={null} curl -g -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[search]=excellent%20service' ``` ### `filter[feed-types][]` Restrict results to specific feed types. Allowed values: `video`, `audio`, `text`, `social`. Pass only the values listed above. If you send an unknown value (e.g. a typo like `vidoe`), the filter is silently dropped and the API returns the full unfiltered list of feeds — not an error. Validate your input client-side before sending. ```bash Single theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[feed-types][0]=video' ``` ```bash Multiple (OR) theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[feed-types][0]=video&filter[feed-types][1]=audio' ``` ```bash All four theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[feed-types][0]=video&filter[feed-types][1]=audio&filter[feed-types][2]=text&filter[feed-types][3]=social' ``` The `video` filter also matches imported social videos (items with `feed_type: "social_feed"` and `social_feed_type: "manual_video"`). The same pattern applies to `audio` and `text` — the filter matches by content type, not by storage table. ### `filter[favourite]` Return only favourited feeds. Pass `true` to enable; omit this parameter to include favourited and non-favourited feeds. ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[favourite]=true' ``` ### `filter[review_with_comment]` Return only feeds that have a non-empty comment. Pass `true` to enable; omit this parameter to include feeds with or without comments. ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[review_with_comment]=true' ``` ### `filter[sentiments][]` Filter by AI-detected sentiment. Allowed values: `positive`, `negative`, `neutral`. Pass only the values listed above. If you send an unknown value, the filter is silently dropped and the API returns the full unfiltered list of feeds — not an error. Validate your input client-side before sending. ```bash Single theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[sentiments][0]=positive' ``` ```bash Multiple (OR) theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[sentiments][0]=positive&filter[sentiments][1]=neutral&filter[sentiments][2]=negative' ``` ### `filter[star-rating][]` Filter by star rating. Accepts integers from `1` through `5`. Pass only integers `1`–`5`. Out-of-range values (e.g. `99`) return an empty result, while non-numeric values (e.g. `abc`) are coerced to `0` and may return unrated items. Validate your input client-side. ```bash Single theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[star-rating][0]=5' ``` ```bash Multiple (OR) theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[star-rating][0]=4&filter[star-rating][1]=5' ``` ### `filter[feed-forms][]` Filter to feeds collected via specific review forms. Pass the numeric form `id` — **not** `unique_form_id`. Get the numeric `id` from the [List Review Forms](/api-reference/ReviewForms/get-all-forms) endpoint — it is the integer `id` field on each form object. ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[feed-forms][0]=10644' ``` ### `filter[review-labels][]` Filter by review label ID(s). Label IDs are strings (e.g. `01krk3zwze14apa6gmx045ky8a`). Get the available label IDs from the [List Review Labels](/api-reference/Labels/list-labels) endpoint — use the `id` field from each label object. ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[review-labels][0]=01krk3zwze14apa6gmx045ky8a' ``` ### `filter[imported-froms][]` Filter to feeds imported from specific source platforms (Google, YouTube, Wistia, Product Hunt, etc.). Accepts numeric platform IDs. A public listing endpoint for import-platform IDs is on the roadmap. Until then, contact support to obtain the ID mapping for the platforms relevant to your workspace. ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[imported-froms][0]=21' ``` ## Pagination Results are paginated with **15 items per page**. Use `?page=` to navigate. ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?page=2' ``` The response includes `first_page_url`, `next_page_url`, and `prev_page_url`. `next_page_url` is `null` on the last page; `prev_page_url` is `null` on the first. ## Combining filters Mix any of the above; a keyword search combines with the other filters the same way (AND). The example below requests positive-sentiment reviews that mention `Dewalt`: ```bash theme={null} curl -g -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[search]=Dewalt&filter[sentiments][0]=positive' ``` This next example requests favourited video- or audio-type feeds with positive sentiment, a 4- or 5-star rating, and a non-empty comment: ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[feed-types][0]=video&filter[feed-types][1]=audio&filter[favourite]=true&filter[sentiments][0]=positive&filter[star-rating][0]=4&filter[star-rating][1]=5&filter[review_with_comment]=true' ``` ## URL encoding the brackets The `filter[...]` syntax contains literal `[` and `]`. Most HTTP clients (Postman, Python `requests`, JavaScript `fetch`, Insomnia) handle this transparently. Two things to watch for: * **`curl`** interprets `[` and `]` as URL-globbing ranges by default. Add the `-g` flag (alias `--globoff`) — or URL-encode as `%5B` and `%5D` — to suppress that behaviour: ```bash theme={null} curl -g -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[feed-types][0]=video' ``` * **Browsers / fully-encoded clients** will accept the percent-encoded form too: ``` https://api.feedspace.io/v3/feeds?filter%5Bfeed-types%5D%5B0%5D=video ``` ## Response shape Each item in `data.data[]` carries a top-level `feed_type` (`audio_feed`, `video_feed`, `text_feed`, or `social_feed`) which determines which type-specific block is present on the item: * `feed_type: "audio_feed"` → `audio_feed` block with `file_url`, `transcript`, etc. * `feed_type: "video_feed"` → `video_feed` block with `file_url`, `static_thumb_url`, `transcript`, etc. * `feed_type: "text_feed"` → `text_feed` block with the review text content. * `feed_type: "social_feed"` → `social_feed` block with `social_platform`, `attachments`, plus a `social_feed_type` field on the item (`social`, `manual_text`, `manual_video`) that indicates the sub-category. All items also include `review_labels` (an array of `{ id, name, attributes }` objects) — possibly empty. # Bulk Import Source: https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/import-csv-text-review POST /imports/csv-imports/text-review Import multiple text reviews from a CSV or Excel file. [📥 Download Sample CSV File](https://static.feedspace.io/assets/sample-csv-import.csv) The sample file includes all supported columns with example data. See the format specification below for detailed column requirements. ## CSV Format The CSV file should include the following columns: * **Review Text** (required): The actual review content * **Review Date** (optional): Date when the review was posted * **Star Rating** (optional): Rating from 1-5 (supports decimals like 1.5, 2.5) * **Name** (optional): Customer's name * **Email** (optional): Customer's email address (must be valid email format) * **Job Role** (optional): Customer's job title/position * **Company** (optional): Customer's company name * **Profile Image URL** (optional): Customer's profile image URL (must be valid URL format) # Import Text Review Source: https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/import-text-review POST /imports/self-imports/text-review Import a text review manually into the workspace. All fields are optional, but at least one of the following must be provided: `rating`, `review`, or `attachments`. # Import Video Review Source: https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/import-video-review POST /imports/self-imports/video-review Import a video review manually into the workspace. All fields are optional. If `type` is 'file', then `attachments[]` (video files) is required. If `type` is not 'file' or omitted, then `attachment_urls[]` (S3 URLs) is required. # Import from Web Link Source: https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/import-web-link POST /imports/self-imports/web-link Import Reviews from Web Link. Enter the web link url from where you want to import reviews into Feedspace. # Screenshot to Review Source: https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/screenshot-to-review POST /imports/self-imports/image-to-text-review Screenshot to Review. Upload a screenshot of your review to automatically import it. # List Review Labels Source: https://docs.feedspace.io/api-reference/Labels/list-labels GET /review-labels Get all review labels defined in the workspace. Use the `id` returned by this endpoint as the value for `filter[review-labels][]` on GET /feeds. Get all review labels defined in the workspace. Each label has a stable `id` that you can pass to `filter[review-labels][]` on [`GET /feeds`](/api-reference/Feeds/list-feeds) to fetch all feeds tagged with that label. ## Query Parameters ### `include[]` Optional. Pass `reviews_count` to include the number of feeds tagged with each label. ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/review-labels?include[]=reviews_count' ``` ## Response Returns a `data` array of label objects: ```json theme={null} { "data": [ { "id": "01krk3zwze14apa6gmx045ky8a", "name": "liked", "attributes": { "css_color_code": "#EA580C" }, "reviews_count": 1 } ] } ``` | Field | Type | Description | | --------------------------- | ------- | --------------------------------------------------------------------------------------------- | | `id` | string | Label ID. Pass to `filter[review-labels][]` on `GET /feeds`. | | `name` | string | Display name of the label. | | `attributes.css_color_code` | string | Hex colour used to render the label in the UI. | | `reviews_count` | integer | Number of feeds tagged with this label. Only present when `include[]=reviews_count` was sent. | ## Using a label ID Once you have a label `id`, fetch all feeds tagged with it: ```bash theme={null} curl -u "$API_KEY:$SECRET_KEY" \ 'https://api.feedspace.io/v3/feeds?filter[review-labels][0]=01krk3zwze14apa6gmx045ky8a' ``` See [List All Feeds](/api-reference/Feeds/list-feeds) for the full set of filters supported on the feeds endpoint. # Create Review Form Source: https://docs.feedspace.io/api-reference/ReviewForms/create-form POST /forms Creates a new review form. # Delete Review Form Source: https://docs.feedspace.io/api-reference/ReviewForms/delete-form DELETE /forms/{unique_form_id} Permanently deletes a review form by its `unique_form_id`. **This also deletes every review collected through the form** — video, audio and text — along with the form's questions and its submission logs. Deleting a form cannot be undone through the API. If the form is embedded on your site, remove the embed code separately: deleting the form does not remove it from your pages. Deleting a review form also deletes **every review collected through it** (video, audio and text), together with the form's questions and submission logs. This cannot be undone through the API. If the form is embedded on your website, remove the embed code separately. Deleting the form does not remove it from your pages. # Get All Review Form Source: https://docs.feedspace.io/api-reference/ReviewForms/get-all-forms GET /forms Returns a list of all review forms. # Get Review Form Source: https://docs.feedspace.io/api-reference/ReviewForms/get-form GET /forms/{unique_form_id} Returns a single review form by its `unique_form_id`. # Update Review Form Source: https://docs.feedspace.io/api-reference/ReviewForms/update-form PUT /forms/{unique_form_id} Updates an existing review form by its `unique_form_id`. # All Text Reviews Source: https://docs.feedspace.io/api-reference/TextReviews/all-text-reviews GET /feeds Get a paginated list of feeds across the workspace. Supports optional filters: `filter[search]`, `filter[feed-types][]`, `filter[favourite]`, `filter[review_with_comment]`, `filter[sentiments][]`, `filter[star-rating][]`, `filter[feed-forms][]`, `filter[review-labels][]`, and `filter[imported-froms][]`. All filters are optional; filters of different types are AND-combined, while values within a single filter array are OR-combined. Get a paginated list of all text feeds received. ## Query Parameters * `filter[feed-types][]` (required): Set to `"text"` to filter text feeds * `page` (optional): Page number for pagination (default: 1) ## Example Request ```bash theme={null} GET /feeds?filter[feed-types][]=text&page=1 ``` ## Response Returns a paginated list of text feeds with feed fields, question answers, and other details. # Update Text Review Source: https://docs.feedspace.io/api-reference/TextReviews/edit-text-review POST /feeds/text/{text_feed_id} Edit a specific text review. Edit a specific text review. This endpoint accepts multipart/form-data and allows updating various fields of a text feed. # Single Text Review Source: https://docs.feedspace.io/api-reference/TextReviews/single-text-review GET /feeds/text/{text_feed_id} Get details of a specific text feed based on text feed ID. Get details of a specific text feed based on text feed ID. # Delete Text Review Source: https://docs.feedspace.io/api-reference/TextReviews/soft-delete DELETE /feeds/text/{text_feed_id} Delete a specific text review from the list. # All Video Reviews Source: https://docs.feedspace.io/api-reference/VideoReviews/all-video-reviews GET /feeds Get a paginated list of feeds across the workspace. Supports optional filters: `filter[search]`, `filter[feed-types][]`, `filter[favourite]`, `filter[review_with_comment]`, `filter[sentiments][]`, `filter[star-rating][]`, `filter[feed-forms][]`, `filter[review-labels][]`, and `filter[imported-froms][]`. All filters are optional; filters of different types are AND-combined, while values within a single filter array are OR-combined. Get a paginated list of all video feeds received. ## Query Parameters * `filter[feed-types][]` (required): Set to `"video"` to filter video feeds * `page` (optional): Page number for pagination (default: 1) ## Example Request ```bash theme={null} GET /feeds?filter[feed-types][]=video&page=1 ``` ## Response Returns a paginated list of video feeds with feed fields, question answers, and other details. # Update Video Review Source: https://docs.feedspace.io/api-reference/VideoReviews/edit-video-review POST /feeds/video/{video_feed_id} Edit a specific video review. # Single Video Review Source: https://docs.feedspace.io/api-reference/VideoReviews/single-video-review GET /feeds/video/{video_feed_id} Get details of a single Video Review. # Delete Video Review Source: https://docs.feedspace.io/api-reference/VideoReviews/soft-delete DELETE /feeds/video/{video_feed_id} Delete a specific video review from the list. # All Pages Source: https://docs.feedspace.io/api-reference/WallOfLove/all-pages GET /pages Get all pages. # Create Page Source: https://docs.feedspace.io/api-reference/WallOfLove/create-page POST /pages Create a new page. # Get All Reviews (Pages) Source: https://docs.feedspace.io/api-reference/WallOfLove/get-reviews GET /pages/feeds Get all reviews for pages, with filters for feed types, favourite, forms, imported sources, sentiments, ratings, labels, and search. # Get Selected Feeds Source: https://docs.feedspace.io/api-reference/WallOfLove/selected-feeds POST /pages/selected-feeds Get feed details for selected feed identifiers. This endpoint accepts an array of feed identifiers and returns the corresponding feed details formatted for pages. # Update Page Source: https://docs.feedspace.io/api-reference/WallOfLove/update-page PUT /pages/{unique_page_id} Update an existing page. # Authentication Source: https://docs.feedspace.io/api-reference/authentication Feedspace API uses Basic Authentication for all API requests. You must provide your API Key and Secret Key in the `Authorization` header using the Basic Auth scheme. ⚠️ **Keep your credentials secure!** Do not share your API Key or Secret Key with others or expose them in any client-side code (browsers, apps). Credentials should be securely loaded from an environment variable or key management service on the server. Credentials are provided via the `Authorization` header in the following format: ```bash theme={null} Authorization: Basic BASE64_ENCODED_CREDENTIALS ``` Where `BASE64_ENCODED_CREDENTIALS` is the Base64 encoding of `api_key:secret_key`. You can obtain your API Key and Secret Key from **[Feedspace → Automation → API](https://app.feedspace.io/automation/api)**. ### Example Request ```bash theme={null} curl https://api.feedspace.io/v3/{ENDPOINT} \ --header 'Authorization: Basic ' ``` All API endpoints require authentication using valid Basic Auth credentials. # Product Updates Source: https://docs.feedspace.io/changelog/product-updates Feedspace is constantly evolving. See what’s new and improved. ## Feedbox * **Add to Page / Widget**: Add a review to multiple Wall of Love pages and widgets at once, right from the Feedbox 3-dot menu. * Video and Audio filters in Feedbox now also surface imported reviews with matching media, not just reviews recorded directly on Feedspace. * Bulk-deleting reviews now removes them from your live Widgets and Wall of Love pages immediately. ## Forms * **AI Native Form Predefined Questions**: Build your AI Native Form with a fixed list of questions instead of letting AI generate them on the fly, and choose exactly how many questions the AI asks when using AI-generated interviews. * AI Native Form now supports right-to-left languages, shows a clearer permission-request screen, and displays a paused-form banner with your own custom message when submissions are closed. * The AI Native Form thank-you screen now shows a celebratory confetti animation, and required star ratings or comments are validated before submission. * Links to a deleted form now show a clear "no longer available" message instead of a generic error page. ## Import Reviews **Import History** * See a history of past URL imports under Automated Imports, including the platform, how many reviews came in, and when, and start auto-sync on any of them with one click. * Editing the rating, labels, or translation language on an existing auto-sync now works correctly from the edit popup. **Manual imports** * **Audio Reviews**: Manually import audio reviews, alongside your existing text, video, and image imports. * Manual video import upload limit raised to 500MB. ## Share *Updates of Wall of Love and Widgets,* * **Creative Space Video**: Turn video testimonials into shareable clips with automatically generated captions, and save your edits as a draft to finish later. * **Avatar Blocks**: Customize the avatar border. * **Carousel Slider**: New sliders now have Autoplay, navigation arrows, and slide indicators turned on by default. * **Deferred Widget Loading**: Control when a widget loads on your page (on page load, when the browser is idle, when it scrolls into view, on interaction, or via a custom trigger) to keep your site fast. * Single review embeds now correctly display reviews whose only content is a video, including newly supported Wistia clips alongside YouTube, TikTok, and SoundCloud. ## Automation New feature added! 🎉 * **Slack Integration**: Connect your Feedspace workspace to Slack to get notified whenever a new review comes in. * **Stripe Customers**: Connect your Stripe account under Customers → Integrations to automatically import your paying customers as contacts for review-request email sequences. * **Per-Email Scheduling**: Set a different wait time, send time, and time zone for each email in your automation sequence, and choose whether to include contacts who already left a review. * API and automation keys are now masked in your dashboard by default, shown in full only briefly right after they're generated or regenerated. ## Custom Domain * **Activation Status**: The workspace list now shows an "Activate Domain" badge whenever a custom domain is pending activation. ## Workspace * New accounts now get their first workspace automatically named after your company (detected from your signup email) instead of the generic "My First Workspace". * When you're added to a shared workspace, you can now see who owns it. ## Forms New form added! 🎉 * **AI Native Form**: A new AI-powered form type that collects reviews through a friendly conversation. Describe your goal and Feedspace builds an interactive form with voice, text, and video response options. The AI Native Form can be embedded on your site inline or as a popup triggered by any button on your page. * **More Custom CSS**: The custom CSS limit for forms, pages, and widgets is now 1,500 characters, up from 500, giving you more room to personalize your design. ## Automation New feature added! 🎉 * **Form Email Automation**: Set up automated review-request email sequences from a new Automation tab inside your form editor. Configure your audience (all contacts or filtered by customer tag), set a send schedule and timezone, and personalize the email template with merge variables. Custom SMTP and Amazon SES sending are supported on higher plans. * **Customers**: A new Customers section in the dashboard gives you a centralized contact list. Add people manually, import from a CSV file, or let Feedspace automatically sync contacts from incoming reviews. See who has already submitted a review and tag contacts to target specific groups in your email automations. * **MCP Connectors Guide**: A new Connectors tab in your account settings provides step-by-step setup instructions for connecting Feedspace to AI assistants including Claude, ChatGPT, Perplexity, and Bolt. ## Import Reviews **New import sources** * **Trustedshops** * **Healthgrades** * **AlternativeTo** * **ProAdvisor** (QuickBooks) * **Niche** * **ConsumerAffairs** * **Google Store Pages** * **Redbubble** * **Lawyers.com** * **Nolo Store** * **Martindale** * **Travel Agent Finder** * **Realtor.com** * **Justia Lawyers** **Import experience** * **Fewer duplicate reviews**: When auto-sync is enabled alongside review translation, Feedspace no longer creates duplicate reviews for content already in your target language. ## Share *Updates of Wall of Love and Widgets,* * **Creative Space V2**: Creative Space has been redesigned with a new interface and AI image generation. Describe the testimonial graphic you want and Feedspace generates a polished, shareable image ready for social media and marketing. * **Angular embed code**: The widget embed dialog now includes a ready-made Angular snippet, so Angular developers can copy-paste it directly instead of adapting the generic embed code. * **iFrame option for popup form embeds**: The iFrame embed code is now available when sharing a form as a popup, where it was previously hidden. * **Widgets in Framer and flex layouts**: Widgets now display at their correct size when embedded in Framer-built pages or websites using flex and grid layouts, preventing content from collapsing or overflowing. * **Read More for rich review content**: The Read More / Read Less button in widgets now works correctly for platforms that use rich formatted review text, including Booking.com and VRBO. ## Feedbox * **Trim Audio and Video**: You can now trim audio and video recordings directly from the Feedbox — select the clip range and save a polished version without leaving your dashboard. ## Forms * **Customizable Thank-You Redirect Message**: Forms can now show a personalized message with a countdown timer before automatically redirecting visitors after submission. * **Video and Audio Capture Preview**: When building your form, you can now preview exactly how the video and audio capture screens will appear to respondents before publishing. * **Star Rating No Longer Pre-Selected**: The star rating field no longer defaults to 5 stars, ensuring respondents make a deliberate rating choice. * **Website fields accept URLs without “https\://”**: On your review form, fields that ask for a website or link (for example company URL or similar) accept addresses like `example.com` or `www.example.com`. Feedspace adds the correct `https://` prefix automatically so respondents do not need to type the protocol. ## Import Reviews **New import sources** * **Bluesky** * **Vimeo** * **Reviews.io** **Bulk import** * **Excel (.xlsx)**: Import reviews in bulk from a spreadsheet file. **Import experience** * **More sorting options**: When importing from platforms such as Reddit, App Store, and Goodreads, you can sort reviews by most relevant, oldest, most helpful, or lowest rated. ## Share *Updates of Wall of Love and Widgets,* ### New widgets New widget added! 🎉 * **Avatar Blocks Widget**: Display reviewer avatars in a dynamic block layout with autoplay, adjustable speed, hover fade-out effect, and customizable avatar borders. New widget added! 🎉 * **SEO Rich Snippet Widget**: Automatically inject structured JSON-LD data into your page so search engines can display star ratings and review counts directly in search results — no coding required. *** ### Widget settings and display * **RTL Language Support**: All widgets now correctly display in a right-to-left layout for Arabic and other RTL-language websites. * **Reviews Open Fully Expanded in Modals**: Clicking any review card in a widget now opens the full review text immediately, without needing an extra tap to expand it. * **"Show Full Review" Hides Read More/Less Buttons**: When you disable "Shorten Long Reviews" in widget settings, review cards now display the complete text with no toggle button. * **Single Review Embed Scales for Small Containers**: The single review embed now automatically adjusts its size when placed in narrow or small spaces, keeping the review card readable in any layout. * **Localized Date Format**: Review dates in widgets now display in a shorter, locale-friendly format (e.g., 15 Jan 2024). ## Chrome Extension * **Seamless Sign-In Sync**: The Chrome Extension is now automatically notified when you sign in through the Feedspace web app, keeping your session in sync without any manual steps. ## Workspace * **Leave Workspace Confirmation**: A confirmation dialog now appears before you leave a shared workspace, preventing accidental exits. ## Import Reviews **New import sources** * **Fourthwall** * **Printful** * **WooCommerce** * **Bark** * **BigCommerce** * **LegalMatch** * **Influenster** * **Upwork** **Auto-sync** * **Auto-Sync Expanded**: Imports now sync automatically for **Zillow**, **Groupon**, **Google Workspace**, and **Alibaba**, keeping your collected reviews up to date without manual re-imports. ## Share *Updates of Wall of Love and Widgets,* ### New widgets New widget added! 🎉 * **Cross Slider Widget**: A dynamic cross-scrolling slider that displays reviews in a smooth, continuous animation. Customize slide direction, speed, background color, and card borders. New widget added! 🎉 * **Avatar Card Carousel Widget**: Display reviewer avatars in a polished carousel card format for a more personal and visually rich testimonial experience. New widget added! 🎉 * **Company Logo Slider Widget**: Showcase company logos from your reviewers in a smooth, scrolling slider to highlight brand trust and social proof. * **Floating Cards Widget**: Display your testimonials as gently animated floating cards for a dynamic and eye-catching experience on your site. *** ### Widget settings and display * Enhanced **dark mode** support across all widget types for a consistent look on dark-themed websites. *** ### Integrations and preview * **Framer Plugin**: Install Feedspace widgets directly from Framer to embed your review displays into Framer-built websites. * **Live Preview**: Customize widgets and forms with an instant real-time preview so you can see exactly how they will look on your site before publishing. ## Feedbox * **Pro Editor**: Request professional video editing for your video testimonials directly from the Feedbox — submit the clip and receive a polished, ready-to-publish video. * Added an inline **Clear Filters** button to the feed header that appears whenever filters or a search are active, making it easy to reset your view in one click. ## Forms * **SEO-Friendly URLs**: Forms and Wall of Love pages now support custom slugs, giving you clean, readable URLs that are easier to share and better for search visibility. ## Workspace * **Subscription Management**: Access the Stripe billing portal directly from your workspace to manage your plan, update payment details, or review billing history. ## Platform Improvements * Migrated the entire platform to a new, modern architecture for improved performance, reliability, and faster feature delivery. * Redesigned core experiences across Forms, Pages, Widgets, Workspace management, and authentication for a smoother, more consistent user experience. * Improved page load speeds and overall app responsiveness across the board. ## Automation New feature added! 🎉 * **Feedspace MCP Server**: Connect AI assistants like Claude, ChatGPT, Cursor, and other MCP-compatible clients to your Feedspace account using the Model Context Protocol. * Browse, filter, favourite, and label your reviews using natural language. * Create and manage forms, widgets, and Wall of Love pages through your AI assistant. * 35+ tools available across 8 modules with secure OAuth 2.1 authentication. * [Setup Guide](https://docs.feedspace.io/mcp/setup) ## Feedbox * Updated feed details view from the old pop-up to a new **drawer UI** for a cleaner, more user-friendly experience. * Added review translation, transcript editing, and the ability to add social URLs for a more enhanced user experience. Feedbox review detail opens in a side drawer ## Import Reviews We have added new imports, * **Thumbtack** * **Psychology Today** * **OpenTable** * **GrowthMentor** * **GreatSchools** * **Checkatrade** * **DealerRater** * **Foursquare** * **Google Shopping** * **Google Workspace** * **Shopify Partner** ## Share *Updates of Wall of Love and Widgets,* * **Automated Review Alerts**: Receive email notifications when a review is automatically added to your wall of love or widget through your curated filters. * **Improved Widget Loading**: Widgets now load more smoothly, even when multiple widgets are on a page or when the internet connection is slow. * **Automatic Widget Fix**: If a widget fails to load, it will automatically try again, so temporary issues won’t affect your experience. ## Feedbox * **Global Search**: Instantly search testimonials by name, review text, company, or transcript. New feature added! 🎉 * **Review Labels**: Add labels to reviews for better organization and categorization. * Labels can also be used as filters to streamline review search and management. Applying a label to an individual review in Feedbox * **Review Label Bulk Action**: Apply labels to multiple reviews at once for faster organization. * Labels remain usable as filters for easier review search and analysis. Bulk-applying labels to multiple reviews * **Manage Labels:** Added enhanced label management with options to rename and delete existing review labels. Managing review labels — rename and delete ## Analyze Reviews - New Feature 🎉 * **Review Analysis**: Instantly analyze your reviews by selecting Overview, Positive Points, Pain Points, or Improvements. * Get a quick summary to help you gain valuable insights and make informed decisions. Review Analysis with overview and insight tabs ## Forms New feature added! 🎉 * **Pause/Activate Forms:** Pause review forms to stop new submissions and reactivate them at any time. Pause and activate controls on a review form * **Auto-Tag Collected Reviews**: Automatically apply labels to new reviews based on settings defined in the review form. Auto-tag labels configured on a review form ## Import Reviews We have added new imports, * **HubSpot** * **Alibaba Product** * **AliExpress** * **BBB (Better Business Bureau)** * **CarGurus** * **Cars.com** ## Share *Updates of Wall of Love and Widgets,* * Added **review preview while selecting reviews**, making the selection process clearer and more seamless for both WOL and widget setup. * Added **Load More** option to the **Masonry Widget**, expanding the feature beyond pages. * Updated the **public widget preview UI** with a refreshed and more seamless design. * Added a **Preview** button in the header for instant preview access. * Introduced customization options for **external link color** and **highlight background color** in reviews. * Improved UI hierarchy in the **Customization** section for better navigation. New feature added! 🎉 * **Creative Space**: Transform any existing testimonial into a beautifully designed, shareable image in seconds. * Create polished, social-ready graphics ideal for marketing pages and promotional campaigns. * Highlight customer stories in a more visual and engaging format. Creative Space generating a shareable graphic from a testimonial New feature added! 🎉 * **Review Curation Automation**: Automatically add new reviews to your Wall of Love and Widgets based on conditions you set. * Reviews update in real time with no manual work needed. * Ensures your best and latest feedback is always showcased front and center. Review curation automation rules for Wall of Love and widgets ## Branding Assets * **Brand Fonts**: Set your brand typography globally from Branding Assets; fonts auto-apply to all newly created WOLs, forms, pages, and widgets. Brand Fonts applying typography across forms, pages, and widgets ## Other Improvements * The login screen now remembers the **last used email and login method** for quicker sign-ins. ## Feedbox * **Auto-Update Sync**: When reviews are updated or deleted, the changes are automatically reflected on the Wall of Love and Widgets. New feature added! 🎉 * **Export Reviews**: Export all Form Reviews and Imported Reviews in one click. Export reviews from Feedbox * **Duplicate Review**: Quickly duplicate any specific review directly from the Feedbox page. ## Forms ### Translation and languages New feature added! 🎉 * **Language customization**: Translate review forms into multiple languages, manage languages in form settings, and use **form translation** so respondents see the right language. Review form language and translation settings ### Thank-you page * **Multi-Platform Review Collection**: On the form thank you page, added support to collect reviews from **Google**, **Trustpilot**, and **Yelp** directly after form submission. Thank-you page offering Google, Trustpilot, and Yelp review links ### Form customization * **Form Preview:** The redesigned preview section is now live with an improved layout and user experience. * Added option to include **links in consent text** for better customization. * Introduced **Custom CSS** support to style forms as per brand preferences. * Added a setting to **show or hide** the Feedspace sign-up button on form thank you page. ## Import Reviews **Manual Import Text & Video Review** * Enhanced with new fields for richer context and authenticity. * Added **Review Date**, **Company Website**, and **Company Logo** when importing text or video reviews. Manual import with review date, company website, and logo fields * Added **Podchaser** to auto-import platforms, allowing direct review imports from Podchaser. We have added new imports, * **ProvenExpert** * **ImmoScout24** ## Share *Updates of Wall of Love and Widgets,* * **Wall of Love:** Added Load More Button option, allowing users to toggle and control how reviews are displayed on the page. * **Preview:** Redesigned preview section is now live with an improved layout and user experience. Wall of Love page with redesigned preview * Added **Social Redirection Control** to enable or disable clickable social icons in Page (WOL) and Widget settings. * Added the **Hide Social Platform Icon** option to show or hide platform icons on reviews. * Includes a separate toggle to control **social redirection** visibility. Hide platform icons and social redirection options on widgets * Improved **Avatar Widget** design with star rating display and customizable text below the avatar group. Avatar widget with star ratings and custom caption text * Added **Sort By** options (**Latest** & **Oldest**) in the **Change Order** tab for easier review arrangement. ## Automation **Pabbly Integration** - Feedspace is now live on Pabbly! 🎉 * Connect and automate workflows between Feedspace and other apps using Pabbly. Pabbly Connect integration with Feedspace ## Feedbox New feature added! 🎉 * **Bulk Action**: Perform actions on multiple reviews at once. Mark as Favorite, Unfavorite, or Delete in bulk. Bulk actions on selected reviews in Feedbox **Filters** * We have added Star Rating and Sentiment filters. * Available in Feedbox, Pages, and Widget. ## Import Reviews We have added new imports, * **Trip.com** * **HomeAdvisor** * **ClassPass** * **Facebook Post** * **Threads Post** * **Facebook Reviews** * **Gartner** * **Reddit Post** * **Reddit Comments** New Manual Imports Added * **Import from Web Link**: Import reviews directly using a web link. * Available under Import modal → Self Import → Import from Web Link. * **Bulk Import**: Import text reviews using a CSV file. * Available under Import modal → Self Import → Bulk Import. Import modal listing new review sources ## Share *Updates of Wall of Love and Widgets,* * **Updated share flow:** Share options are now inside the **Create Page** and **Create Widget** modals instead of a separate modal. Share options inside Create Page and Create Widget modals * **Select All Reviews**: Quickly select all reviews on the page and in widgets to create a wall of love and widgets with multiple reviews. * **Custom CSS**: In the customization of pages and widgets, added a custom CSS option to style and personalize the wall of love and widgets. * **Duplicate Widget**: Users can duplicate existing widgets directly from the menu. ## Automation * Added two more platforms in automation, * Notion * Giftogram Gift Card Automation integrations including Notion and Giftogram ## Custom Domain * **Automated Setup**: Custom domain setup is now fully automated. * Click "Verify Domain" in settings to auto-generate server configuration. * Domain becomes active within 15–25 seconds. ## Branding Assets * Redesigned Branding Assets screen with new interactive UI elements. Redesigned Branding Assets screen ## Feedspace Apps * **WordPress Plugin**: Feedspace plugin is now available on WordPress. * Install it directly from the [WordPress Plugin Directory](https://wordpress.org/plugins/feedspace). * The plugin supports embedding widgets from the plugin. Feedspace WordPress plugin in the plugin directory ## Feedbox * Users can now manually add or update all static user information in any form review, even if the submitter did not provide it during review submission. * Added manual video import icon on reviews. Clicking the icon opens the review detail modal. * New Feedbox List UI is now live with a refreshed design. Feedbox list view with refreshed layout ## Forms * Added a default profile picture option in the user details setup fields. * Added "Send Email" option in the Share Form dialog to copy and paste email content into Gmail or any email service. Share Form dialog with Send Email option ## Import Reviews * Added **SourceForge Product** reviews import. * **SourceForge Project** reviews import is now available. * **Whop** review imports are now live. ## Widgets **New Avatar Slider Widget** * A sleek widget that highlights one review at a time in a smooth, engaging slider format. **New Avatar Group Widget** * Displays multiple reviewer avatars together in a compact, stylish, and visually engaging format. **New Strip Slider Widget** * A smooth, scrolling strip-style widget that continuously displays reviews in an eye-catching and dynamic way. New Avatar Slider, Avatar Group, and Strip Slider widgets ## Chrome Extension * Feedspace Extension [v2.0.1](https://chromewebstore.google.com/detail/feedspace-review-testimon/kkbpoekaicjebadkhhdfcejhkjifhjbi) is live. * Updated to open as a full overlay instead of the old small pop-up view. * Implemented using Shadow DOM for a cleaner, custom layout. ## Custom Domain * Added an option for users to add custom scripts (e.g., third-party analytics), which will execute on public pages after domain activation and verification. Updated the Automation page with **Automation**, **API Access**, and **Webhook** tabs. * Old routes have been removed and redirected to the new structure. Custom Domain and Automation, API, Webhook tabs ## Automation **Zapier Integration** - Feedspace is now live on Zapier. * When a new review is received, you can: * Get notifications in Slack, Discord, or Teams. * Save testimonials to Google Drive or Dropbox. * Send alerts via WhatsApp or Email. * **Submit Testimonial:** Automatically create text or video testimonials in Feedspace from events in other apps. * Examples: turn Slack messages into a text testimonial, or a Google Drive video into a video testimonial. Zapier integration triggers and actions for Feedspace ## API * An API access page is now live. Manual work under all Automation tabs has been removed and streamlined. ## Webhook Setup We have deployed two key updates to our webhook system: * **Signing Secrets:** A unique signing secret is now generated for each webhook to verify requests. Additional UI for viewing secrets was rolled out in a follow-up release. * **Workspace Level Configuration:** Webhooks are now managed at the workspace level instead of the account level. Webhook Integration: * Webhook integration just got easier! Add your endpoint URL, pick events, and activate it right from your Feedspace dashboard. Webhook endpoint setup in workspace settings ## Team Members - New Feature * Invite team members to collaborate in your workspace. * Three roles available: * **Admin**: Full access to manage team members and workspace settings. * **Editor**: Can add, edit, and delete forms, pages, and widgets. * **Viewer:** Can view and share forms, pages, and widgets. * Manage member details and permissions directly from the Team Members page. Team Members roles — Admin, Editor, Viewer ## Feedbox **New Feature**: "Request PRO Edit" Button for Video Reviews * Head to your account and check the purple icon in the **Video Review** section. * Click on it to request a pro edit. Our video editing team can create reels! Request PRO Edit button on a video review ## Forms * Implemented a new Wizard UI in the forms. * Any additional details submitted through your feedback form will be included in your review email. Added new form stats: * **Form Views**: Total number of views on the form. * **Reviews**: Total number of reviews submitted. * **Conversion Rate**: Percentage of views turned into reviews. Form analytics — views, reviews, and conversion rate **New Feature** * **Thank You GIF/Video**: User can add a custom GIF or video (up to 1 min) in the Thank You tab of review forms to display after submission. ## Import Reviews * Users can import **Instagram** Reels and video posts directly into their Feedspace account. * Users can import **SoundCloud** Audio directly into their Feedspace account. * Users can now easily import **Wistia** videos directly into their Feedspace account. * Users can now easily import **TikTok** videos straight into their Feedspace account within a few clicks. * Users can now migrate reviews from **Famewall.io** to Feedspace with ease. * Autosync is now available for the following platforms: * Apartments.com * Freelancer * Booking.com * Shopify Theme * Chrome extension * Shopify-appstore * Skill-share * Homestars * Themeforest * Capterra * Clutch * Yelp * IMDb ## Pages (Wall of Love) * Implemented a new Wizard UI in the pages. Wall of Love page wizard and customization **New Wall of Love 2.1 - Advanced Customization! 🎉** * **Advanced Customization Options**: Toggle review dates, ratings, and "Read More" functionality. * **Theme Options**: Enable dark theme for a sleek aesthetic. * **Border Customization**: Add stylish borders around review cards. * **Color Palette Control**: Customize page background, text, and card hover colors. * **Real-time Preview**: See changes instantly while customizing. ## Widgets * Widget loading speed improved, now 3x faster for a smoother and quicker experience. * Widget previews are now visible in the widget list. * We changed the default value of 'Enable Read More' to ON. * Implemented a new Wizard UI in the widget. Widget list with inline previews **New tool - Google Review Widget** * You can now create a carousel widget from any business's Google reviews. Just search, click Create Widget, and you’re done! * Try it here: [Google Review Widget tool](https://www.feedspace.io/tools/review-widget/google/) **New Masonry Widget** * A new dynamic grid-style **Masonry Widget** is now available for showcasing content beautifully. Masonry widget grid layout ## Chrome Extension Extension v1.0.5 is live now. What's new, * Facebook Post Scraper * Amazon Product Review Scraper * Shopify Partners Review Scraper * G2 Reviews Scraper * Standardized form handling. (e.g., scroll to error) * Allows review import without text ## Workspace We’ve reorganized workspace settings into tabs: * General Settings * Branding Assets * Custom Domain **Branding Assets - New feature** * You can now auto-fetch branding elements (such as theme colors, button styles, etc.) from your website and apply them across Forms, Pages, and Widgets for a consistent look. Branding Assets auto-fetch from website **Custom Domain** * Quick access to “Setup Custom Domain” has been added to the workspaces list page. ## New: Setup Page Added * A new Setup page has been introduced to guide users through the initial setup process. * **Why it matters:** This new feature eliminates the guesswork after signing up, ensuring that users can quickly and efficiently get the most out of Feedspace from day one. Setup page onboarding checklist ## Onboarding Introduced a **single sign-in page** supporting OTP, social logins, and registration in one place. * **OTP Login**: No password needed, verified via email provider, blocks fake registrations. * **Social Logins**: Facebook, X (Twitter), and LinkedIn login/registration are now available. * **Route Update**: /login and /signup routes are redirected to /signin for a unified experience. Unified sign-in with OTP and social logins ## Feedbox * Users can now edit review text for **Text Reviews** and **Manually Imported Reviews**. ## Forms New feature added! 🎉 * **Google Redirection**: In the Capture Review section, users can now enable “Redirect to Google Review” so that 4 or 5-star reviewers are taken straight to their Google Business profile with the review pop-up opened. Google redirection option on the review capture step ## Import Reviews We have added new imports, * Instagram Post * YouTube Video * LinkedIn Post * X (Twitter) Post New social post and channel import options Added the Migrate reviews option under the Import tab. * Senja to Feedspace * Testimonials to Feedspace Autosync is now available for the following platforms: * Vrbo * Booking.com Attraction * Zomato * Coursera * Apple Podcast * Italki * AppSumo * Oyo rooms * Tripadvisor * Airbnb * Product Hunt Reviews * App Store * Udemy * Fresha * Google Play Store * Heal.me ## Pages (Wall of Love) * Updated UI to support playing YouTube videos directly on the Wall of Love. ## Widgets - New Feature 🎉 Added interactive review displays to showcase on the website with easy embed codes, live preview, and full design customization. First Widget Release, * **Carousel Widget**: Ideal for landing pages and review sections. Carousel widget embed preview ## Chrome Extension * The new Chrome Extension version is live with simplified permission handling for users. * Extension version **v1.0.2** adds support for importing from new platforms: * Fiverr Reviews * X (Twitter) Posts * Instagram Posts * LinkedIn Posts * YouTube Comments * YouTube Community Posts ## Forms * **Duplicate Forms**: Added functionality to duplicate existing forms directly from the form menu. Interesting Update! * Added option to create forms directly from a **prompt + website** to auto-fetch logo, colors, and other details. **New Feature** * **Intro Video/GIF**: Users can now add a 1-minute video or GIF to their review forms. * An option is available while editing forms; the system automatically converts for browser compatibility. * The uploaded video or GIF appears at the start of the form for customers. ## Import Reviews * Google review imports now include review images. * Currently, the first image is displayed, with support for more photos coming soon. New manual import added * **Import Video Review**: Manually add video reviews using a dedicated form. * Single review submission supports rating, text, and video together. We have added new imports, * Clutch * Shopify Theme * Vrbo * Capterra Import tab showing Clutch, Shopify Theme, Vrbo, and Capterra **New Big Feature 🎉** * **Auto-Sync Reviews**: Automatically sync reviews from 80+ platforms, starting with Trustpilot. * New reviews are imported in real time with email notifications. * Configure once, and reviews flow into your Feedspace account without manual imports. ## Pages (Wall of Love) New Functionality Added! * **Wall of Love Customization**: Added option to rearrange reviews with drag-and-drop. * Change the order of testimonials to customize the presentation and highlight key reviews. ## Chrome Extension - New Tool 🎉 * Chrome Extension version **v1.0.1** is live with simplified permission handling for users. ## Forms **Exciting: AI-Powered Form Generator ✨** * Instantly create customized review forms by entering a simple prompt. * Example: “Make a video and text review form for my online tutoring business.” * AI generates a complete form tailored to your needs, saving time on manual setup. AI-powered review form generator ## Import Reviews * **Import Text Reviews**: Users can add past reviews manually or by uploading screenshots. * It supports reviewer details, star ratings, and photos along with review text. We have added new imports, * Apartments.com * Zillow * Chrome Extension * Freelancer * Yelp New apartment and platform review imports ## Feedspace 3.0 Major Upgrade Completed 🎉 We’ve rolled out the full version upgrade across the platform with significant improvements: * **UI Overhaul**: Brand new, modern interface with improved navigation and user experience. * **Database Upgrade**: Optimized schema, faster queries, and improved scalability. * **API Revamp**: REST APIs rebuilt with cleaner endpoints, enhanced security, and better response times. * **Performance Boost**: Reduced load times across pages, optimized caching, and improved concurrency handling. * **Backend Architecture**: Migrated to a more modular system for faster feature development. * **Stability & Security**: Hardened authentication flows, better error handling, and advanced monitoring. ## Feedspace 3.0 Upgrade Kickoff 🚀 * We’ve officially started the **Feedspace 3.0 upgrade**, a complete overhaul of our platform. * This upgrade spans UI, database, APIs, and overall system architecture. * Our focus: faster performance, smoother workflows, and a stronger foundation for upcoming features. ## Import Reviews We have added new imports, * AppSumo * Booking.com ## Forms * Customers can now edit the **instruction page content** in Review Forms. * Updated single review (video, audio, or text) page layout. * Layout now matches the customer’s All-in-One review form design. ## Import Reviews We have added new imports, * ThemeForest * Skillshare * IMDb * HomeStars * WordPress Plugins * Booking.com Attraction * PeoplePerHour Offer * Product Hunt Comments * Italki ## Import Reviews We have added new imports, * AppStore * Airbnb ## Forms Review form has been updated! * **All-in-One Feed Form**: Users can collect audio, video, text, and file uploads in a single form. * It supports customizable formats, guided prompts, consent collection, and detailed customization of labels, buttons, and instructions. * It includes an upgraded Thank You page, redirect options, and additional info fields for richer submissions. All-in-One Feed Form collecting audio, video, text, and files ## Pages (Wall of Love) * Significant improvements have been made to enhance the performance and stability of Wall of Love. ## Custom Domain New feature added! * **Custom Domain**: Personalize your Feedspace pages with your own domain or subdomain. * Available exclusively with the Business Plan, with setup accessible under account settings → Custom Domain. Custom Domain setup for Feedspace pages ## Import Reviews New feature added! * **Import Text Feedback via CSV**: Bulk import existing textual feedback into Feedspace. * Consolidate feedback from multiple sources, including offline channels, in one place. * Upload CSV files through the Import Feeds option in the Feedbox section. CSV import for text feedback in Feedbox ## API Access New feature added! * **API Access:** Developers can now integrate Feedspace into their own systems and workflows. * Build custom integrations, automate processes, and extend functionality. * API documentation available; [API Documentation](https://docs.feedspace.io/api-reference/authentication). API Access settings and documentation link ## Webhook New feature added! * **Webhook Setup**: Connect Feedspace with your own software or platforms. * Automate transfer of testimonials, reviews, or form submissions. * Receive instant notifications for new content and streamline content management. * Check documentation for more details: [Webhook Reference](https://docs.feedspace.io/webhook-reference/webhook-access) Webhook configuration with events and endpoint ## Audio Reviews New feature released! * **Audio Testimonials**: Users can collect genuine voice-based reviews for customers who prefer audio over video. * Users can create dedicated audio forms by enabling only the audio recording option in form settings. * Audio reviews can be showcased on the **Wall of Love**, shared on websites, and distributed across social media. ## Feedspace 2.0 Feedspace 2.0 dashboard overview * **New UI**: Faster, smoother, and more intuitive from login to sharing feeds. * **Video Feed Templates**: Prebuilt templates for common use cases, ready to collect video feedback instantly. * **Video Feedback**: Collect authentic customer and employee testimonials in video format. * Simple workflow: share a link, record a video with the timer, submit, and view it in your live dashboard. * **Upload Pre-Recorded Videos**: Feed Forms now support uploading edited or pre-recorded videos in addition to live recording. * Enable this option under Form Types & Landing Page Settings → Allow Users to Upload File. * **QR Codes**: Collect and share feeds using QR codes for easier access. * **Wall of Love**: Showcase the best text and video feeds on your website or social media as social proof. * Rewritten embed code, upgraded servers, and faster CDN ensure quick loading and better SEO. * Add testimonials to your site without impacting speed or search rankings. * **Refer & Earn**: Share your unique referral link from the dashboard. * Earn \$10 for every signup that converts to a paying customer after 30 days. * No limits on referrals, share via email, social media, or direct messages. * **Email Notifications**: Get real-time alerts when new feeds are received. * Option to enable a weekly summary of all feeds across workspaces. * Manage preferences under Profile → Notification Settings. * **Rebranding:** * Feedbackery is now **Feedspace**, expanding from text-based feedback to a complete, rich content gathering platform. # Use Cases & Examples Source: https://docs.feedspace.io/mcp/examples Practical examples and common workflows for using the Feedspace MCP server with your AI assistant. Here are real-world examples of what you can ask your AI assistant to do with Feedspace. Each example shows the prompt you'd use and the tools the AI will call behind the scenes. ## Common Workflows **Prompt:** "Show me a summary of all my reviews in my workspace" **What happens:** 1. AI calls `list_workspaces` to find your workspace 2. AI calls `get_feed_summary` to get review statistics 3. You receive a breakdown of total reviews, ratings distribution, and sentiment analysis **Prompt:** "Find all 5-star text reviews with positive sentiment" **What happens:** 1. AI calls `list_workspaces` to get your workspace ID 2. AI calls `filter_feeds` with `starRatings: [5]`, `sentiment: ["positive"]`, `feedTypes: ["text"]` 3. You receive a filtered list of your top testimonials **Prompt:** "Create a Wall of Love page called 'Customer Love' with my top-rated reviews" **What happens:** 1. AI calls `list_workspaces` to get your workspace ID 2. AI calls `filter_feeds` to find your best reviews 3. AI calls `create_page` with the page name and review identifiers 4. AI calls `get_page_share` to get the public URL 5. You receive the URL to your new testimonial page **Prompt:** "Create a review form for my SaaS product that collects text and video reviews with a custom thank-you message" **What happens:** 1. AI calls `list_workspaces` to get your workspace ID 2. AI calls `create_review_collection_form` with your customization preferences (review types, thank-you message, etc.) 3. AI calls `get_form_share` to get the shareable link 4. You receive the form link to share with your customers **Prompt:** "Create a carousel widget with my 5-star reviews and give me the embed code" **What happens:** 1. AI calls `list_workspaces` to get your workspace ID 2. AI calls `filter_feeds` to find 5-star reviews 3. AI calls `create_widget` with type 4 (Carousel) and the review identifiers 4. AI calls `get_widget_share` to get the HTML embed code 5. You receive the code snippet to paste into your website **Prompt:** "Create a 'Featured' label and apply it to all reviews with 5-star ratings" **What happens:** 1. AI calls `list_workspaces` to get your workspace ID 2. AI calls `create_label` with the name "Featured" 3. AI calls `filter_feeds` to find all 5-star reviews 4. AI calls `batch_update_feeds` with `action: "assign_labels"` to tag all matching reviews **Prompt:** "Import a testimonial from John Smith at Acme Corp: 'Great product, highly recommended!' with a 5-star rating" **What happens:** 1. AI calls `list_workspaces` to get your workspace ID 2. AI calls `import_text_review` with the reviewer name, company, review text, and rating 3. The review is added to your workspace **Prompt:** "Invite [jane@company.com](mailto:jane@company.com) as an Editor to my workspace" **What happens:** 1. AI calls `list_workspaces` to get your workspace ID 2. AI calls `invite_team_member` with the email and role 3. An invitation email is sent to the team member ## Tips for Best Results * **Be specific about your workspace** if you have multiple — mention it by name (e.g. "in my Acme workspace") * **Mention review types** when filtering — say "text reviews", "video reviews", or "audio reviews" to narrow results * **Use natural language** — the AI will translate your request into the right tool calls * **Ask for links and URLs** when you need shareable outputs (form links, page URLs, embed codes) * **Combine actions** — you can ask the AI to do multi-step workflows in a single prompt (e.g. "Find my best reviews and create a Wall of Love with them") # Feedspace MCP Server Source: https://docs.feedspace.io/mcp/overview Connect AI assistants like Claude, ChatGPT, and Cursor to your Feedspace reviews and testimonials using the Model Context Protocol. The Feedspace MCP server lets AI assistants read, manage, and display your reviews and testimonials through natural language. Instead of navigating dashboards, simply ask your AI assistant to filter reviews, create widgets, build Wall of Love pages, and more. ## What is MCP? The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is an open standard that enables AI assistants to securely connect to external tools and data sources. The Feedspace MCP server implements this protocol, giving AI clients direct access to your Feedspace workspace. ## What Can You Do? Browse, filter, favourite, label, and update your text, video, and audio reviews. Create and customize review collection forms with shareable links. Build embeddable widgets and Wall of Love pages to display your best reviews. Invite team members, manage roles, and organize workspaces. ## Key Highlights * **35+ tools** across 8 modules covering reviews, forms, widgets, pages, labels, workspaces, team members, and imports * **OAuth 2.1 with PKCE** authentication — no API keys to manage, sign in securely with your Feedspace account * **No delete operations** — the MCP server intentionally prevents all destructive actions to keep your data safe from accidental AI-triggered deletions * **Works with popular AI clients** — Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT, and any MCP-compatible client ## Supported Clients | Client | Transport | | ------------------------- | --------------- | | ChatGPT | Streamable HTTP | | Claude | Streamable HTTP | | Lovable | Streamable HTTP | | V0 | Streamable HTTP | | Perplexity | Streamable HTTP | | Any MCP-compatible client | Streamable HTTP | ## Quick Links Connect the Feedspace MCP server to your AI client. Explore all 35+ available tools organized by module. See real-world workflows and example prompts. Fix common issues and find answers to frequently asked questions. # Setup & Installation Source: https://docs.feedspace.io/mcp/setup How to connect the Feedspace MCP server to Claude Desktop, Cursor, VS Code, and other AI assistants. **Prerequisites:** * A [Feedspace account](https://app.feedspace.io/signin) with at least one workspace * An MCP-compatible AI client (Claude Desktop, Cursor, VS Code, etc.) ## Connecting to Claude Desktop 1. Open **Claude Desktop** and go to **Settings** 2. Navigate to the **MCP Servers** section (under Developer settings) 3. Add the Feedspace MCP server with the configuration below 4. Restart Claude Desktop 5. When you first use a Feedspace tool, a browser window will open for you to sign in to your Feedspace account ```json claude_desktop_config.json theme={null} { "mcpServers": { "feedspace": { "url": "https://mcp.feedspace.io/mcp" } } } ``` On macOS, the config file is located at `~/Library/Application Support/Claude/claude_desktop_config.json`. On Windows, it's at `%APPDATA%\Claude\claude_desktop_config.json`. ## Connecting to Other Clients For any MCP-compatible client, use the server URL below and select **Streamable HTTP** as the transport type. Authentication is handled automatically via OAuth 2.1. ``` https://mcp.feedspace.io/mcp ``` ## How Authentication Works The Feedspace MCP server uses **OAuth 2.1 with PKCE** for secure authentication: 1. When you first use a Feedspace tool, your MCP client opens a browser window 2. You sign in to your Feedspace account at `app.feedspace.io` 3. After authorization, a bearer token is issued and stored by your MCP client 4. All subsequent tool calls use this token automatically 5. The token persists across sessions in most clients Your Feedspace credentials are never shared with the AI assistant. The bearer token is scoped to your account and transmitted over HTTPS. You can revoke access at any time from your Feedspace account settings. ## Verify Your Connection After setup, try asking your AI assistant: > "List my Feedspace workspaces" If the connection is working, you'll see a list of your workspaces with their names and IDs. This confirms that authentication and the MCP connection are functioning correctly. # Feeds Source: https://docs.feedspace.io/mcp/tools/feeds Tools for managing reviews and testimonials in your Feedspace workspace. These tools let you browse, filter, update, and organize your collected reviews — including text, video, audio, and social reviews. ## Available Tools | Tool | Description | Try asking | | -------------------- | ------------------------------------------------------------------- | ------------------------------------------------------- | | `get_feeds` | Fetch all your reviews with pagination | "Show me all reviews in my workspace" | | `filter_feeds` | Filter reviews by type, sentiment, star ratings, labels, or keyword | "Find all 5-star text reviews with positive sentiment" | | `get_filter_options` | See available filter options — forms, labels, and import sources | "What filter options are available for my reviews?" | | `get_feed` | Get the full details of a single review | "Show me the details of text review 14067" | | `update_feed` | Update a review's text, title, star rating, or date | "Update the title of this review to 'Great Experience'" | | `favourite_feed` | Mark or unmark a review as favourite | "Favourite this text review" | | `get_feed_summary` | Get an overview — total counts, ratings breakdown, and sentiment | "Give me a summary of all my reviews" | | `batch_update_feeds` | Bulk favourite, unfavourite, assign labels, or remove labels | "Favourite all my 5-star reviews" | # Forms Source: https://docs.feedspace.io/mcp/tools/forms Tools for creating and managing review collection forms. Forms are shareable links where your customers can submit text, video, or audio reviews. These tools let you create forms, customize them, and track submissions. Forms are for **collecting** reviews — to **display** reviews on your website, use [Widgets](/mcp/tools/widgets), or for a standalone testimonial page, use [Wall of Love](/mcp/tools/pages). ## Available Tools | Tool | Description | Try asking | | ------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | `list_forms` | List all review collection forms in your workspace | "Show me all my review collection forms" | | `get_form` | Get the full details and configuration of a form | "Show me the details of my feedback form" | | `get_form_share` | Get the shareable URL and QR code for a form | "Give me the shareable link for my review form" | | `get_form_stats` | Get submission analytics — views, submissions, and conversion rates | "How many submissions has my review form received?" | | `create_review_collection_form` | Create a new form with customizable title, review types, branding, and more | "Create a review form called 'Customer Feedback' that accepts text and video reviews" | | `update_form` | Update any aspect of a form — content, review types, branding, thank-you page | "Change the primary color of my review form to blue" | # Imports Source: https://docs.feedspace.io/mcp/tools/imports Tools for importing reviews into Feedspace. Manually import text reviews and testimonials into your Feedspace workspace with full reviewer details. For bulk imports or importing from platforms like Google, Trustpilot, G2, etc., use the import features in the [Feedspace dashboard](https://app.feedspace.io) directly. ## Available Tools | Tool | Description | Try asking | | -------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | `import_text_review` | Import a text review with the reviewer's name, company, job title, rating, and more | "Import a testimonial from John Smith at Acme Corp with a 5-star rating" | # Labels Source: https://docs.feedspace.io/mcp/tools/labels Tools for organizing reviews with labels. Labels help you categorize and organize your reviews. Create labels, assign them to reviews, and use them to filter your content. Labels can also be applied in bulk using the `batch_update_feeds` tool from the [Feeds](/mcp/tools/feeds) module. ## Available Tools | Tool | Description | Try asking | | ----------------- | ----------------------------------------------------------------- | ---------------------------------------------- | | `list_labels` | List all review labels in your workspace with their review counts | "Show me all my review labels" | | `create_label` | Create a new label with a name and optional color | "Create a red 'Featured' label" | | `assign_labels` | Add one or more labels to a review | "Add the 'Featured' label to this review" | | `unassign_labels` | Remove one or more labels from a review | "Remove the 'Featured' label from this review" | # Wall of Love Source: https://docs.feedspace.io/mcp/tools/pages Tools for creating standalone testimonial pages with shareable URLs. Wall of Love are standalone hosted testimonial landing pages with their own public URL (e.g. `feedspace.io/workspace/page-name`). These pages can be shared directly with anyone. ## Available Tools | Tool | Description | Try asking | | ---------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------- | | `list_pages` | List all Wall of Love pages in your workspace | "Show me all my Wall of Love pages" | | `get_page` | Get details of a specific page | "Show me the details of my Customer Love page" | | `create_page` | Create a new page, optionally with specific reviews pre-selected | "Create a Wall of Love called 'Customer Love' with my best reviews" | | `update_page` | Update a page's name or change which reviews are displayed | "Add my latest 5-star reviews to my Wall of Love page" | | `get_page_stats` | Get view analytics for a page | "How many views has my Wall of Love page received?" | | `get_page_share` | Get the public URL to share with anyone | "Give me the public URL for my Wall of Love page" | # Team Members Source: https://docs.feedspace.io/mcp/tools/team-members Tools for managing workspace team members and invitations. Invite team members to collaborate within your workspace and manage their roles. Available roles are **Admin** (full access), **Editor** (can modify content), and **Viewer** (read-only access). ## Available Tools | Tool | Description | Try asking | | ------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------- | | `list_team_members` | List all team members with their roles and invitation status | "Show me all team members in my workspace" | | `invite_team_member` | Invite a new team member by email with a specific role | "Invite [jane@company.com](mailto:jane@company.com) as an Editor to my workspace" | | `update_team_member_role` | Change an existing team member's role | "Change Jane's role to Admin" | | `reinvite_team_member` | Resend the invitation email to a pending team member | "Resend the invitation to the pending team member" | # Widgets Source: https://docs.feedspace.io/mcp/tools/widgets Tools for creating embeddable testimonial widgets for your website. Widgets are embeddable components that display your reviews on external websites via an embed code snippet. Choose from multiple layout types to match your website design. For a standalone hosted page with its own URL, use [Wall of Love](/mcp/tools/pages) instead. **Available layouts:** Carousel, Masonry Grid, Strip Slider, Avatar Group, Avatar Slider, Vertical Scroll, Horizontal Scroll, and Floating Cards. ## Available Tools | Tool | Description | Try asking | | --------------------- | ------------------------------------------------------- | ----------------------------------------------------------- | | `list_widgets` | List all embeddable widgets in your workspace | "Show me all my testimonial widgets" | | `get_widget` | Get details of a specific widget | "Show me the details of my carousel widget" | | `get_widget_share` | Get the embed code snippet to paste into your website | "Give me the embed code for my testimonial widget" | | `get_widget_stats` | Get view and impression analytics for a widget | "How many views has my testimonial widget received?" | | `create_widget` | Create a new widget with your chosen layout and reviews | "Create a carousel widget with my 5-star reviews" | | `update_widget_feeds` | Change which reviews are displayed and their order | "Update my widget to show only the top 10 positive reviews" | | `replicate_widget` | Duplicate a widget with all its settings and reviews | "Duplicate my carousel widget" | # Workspaces Source: https://docs.feedspace.io/mcp/tools/workspaces Tools for managing Feedspace workspaces. Workspaces are the top-level containers for all your reviews, forms, widgets, and pages. Most tools require a workspace ID — use `list_workspaces` first to get it. ## Available Tools | Tool | Description | Try asking | | ------------------------ | -------------------------------------------------------------------------- | ----------------------------------------------------- | | `list_workspaces` | List all your workspaces — typically the first tool called in any workflow | "List my Feedspace workspaces" | | `get_workspace` | Get a workspace's setup status and permissions | "Show me the status of my workspace" | | `create_workspace` | Create a new workspace with a name and optional website URL | "Create a new workspace called 'My SaaS Product'" | | `update_workspace` | Update a workspace's name or website URL | "Rename my workspace to 'Acme Reviews'" | | `get_workspace_branding` | Extract branding from a website URL to auto-configure forms and widgets | "Extract the branding from my website at example.com" | # Troubleshooting & FAQ Source: https://docs.feedspace.io/mcp/troubleshooting Common issues and solutions when using the Feedspace MCP server. ## Common Issues **Possible causes and solutions:** * Verify you are using the correct server URL: `https://mcp.feedspace.io/mcp` * Make sure you have completed the OAuth sign-in flow in your browser when prompted * Try removing and re-adding the MCP server in your client settings * Check that your Feedspace account is active at [app.feedspace.io](https://app.feedspace.io) * Clear your MCP client's cached credentials and re-authenticate **Possible causes and solutions:** * You must have at least one workspace in your Feedspace account * Sign in to [app.feedspace.io](https://app.feedspace.io) and create a workspace if needed * Ensure you authenticated with the correct Feedspace account * If you were recently added to a workspace, the owner may need to verify your access **Possible causes and solutions:** * Restart your MCP client (Claude Desktop, Cursor, etc.) * Verify the server URL in your client is exactly `https://mcp.feedspace.io/mcp` with no trailing slash or extra path * Ensure you are using **Streamable HTTP** as the transport type **Possible causes and solutions:** * Your role in the workspace may not have sufficient permissions * **Admins** have full access; **Editors** can modify forms, pages, and widgets; **Viewers** have read-only access * Contact the workspace Admin to adjust your role * Use `list_team_members` to check your current role in the workspace **Possible causes and solutions:** * Make sure you are passing the correct `feed_identifier` values (format: `feed-{type}-item-{id}`) * Use `get_feeds` or `filter_feeds` to get the exact identifiers * Verify the reviews exist and belong to the correct workspace * Check that the reviews have not been soft-deleted **Possible causes and solutions:** * If fetching large datasets, use pagination parameters (`page`, `perPage`) to limit results * For bulk operations on many reviews, use `batch_update_feeds` rather than individual calls * If the issue persists, try again after a few moments ## Frequently Asked Questions **No.** The Feedspace MCP server intentionally excludes all delete operations to prevent accidental data loss from AI assistants. To delete reviews, forms, widgets, or pages, use the [Feedspace dashboard](https://app.feedspace.io) directly. The only "removal" operations available are `unassign_labels` (removes a label association, not the review itself) and `unfavourite` (removes the favourite flag). Any client that supports the **Model Context Protocol** with **Streamable HTTP** transport. This includes: * Claude Desktop * Claude Code * Cursor * Windsurf * ChatGPT (via MCP plugins) * Any other MCP-compatible client Yes. Authentication uses **OAuth 2.1 with PKCE**, the industry standard for secure authorization. Your Feedspace credentials are never shared with the AI assistant. The bearer token is scoped to your account and transmitted over HTTPS. Yes. Each team member authenticates with their own Feedspace account. Their access level is determined by their role in the workspace (Admin, Editor, or Viewer). You can revoke OAuth tokens from your Feedspace account settings. The MCP server will require re-authentication on the next use. Any active sessions will be terminated. The MCP server works with your existing Feedspace account. Tool availability depends on your Feedspace plan features. There is no additional charge for MCP access. ## Getting Help Reach out to the Feedspace team for help with any issues. Sign in to manage your reviews, forms, and settings directly. # feed.audio.received Source: https://docs.feedspace.io/webhook-reference/audio-reviews/received This webhook is triggered whenever a new audio review is received in your Feedspace account. ## Webhook Type `feed.audio.received` ## Payload Format ```json theme={null} { "type": "feed.audio.received", "data": { "user": { "id": "USER_ID", "name": "USER_NAME", "email": "USER_EMAIL", "notification": { "received_text_feed": true, "received_audio_feed": true, "received_video_feed": true }, "custom_domain": { "domain": "CUSTOM_DOMAIN", "status": true, "favicon": "FAVICON_URL" } }, "project": { "logo": "LOGO_URL", "name": "PROJECT_NAME", "description": "PROJECT_DESCRIPTION" }, "feed_form": { "id": "FORM_ID", "url": "FORM_URL", "logo": "FORM_LOGO_URL", "name": "FORM_NAME" }, "feed_id": "FEED_ID", "feed_url": "FEED_URL", "audio_url": "AUDIO_FILE_URL", "audio_size": "AUDIO_SIZE_IN_BYTES", "audio_extension": "AUDIO_FILE_EXTENSION", "response": { "Name": "RESPONDER_NAME", "Email": "RESPONDER_EMAIL", "type": "REVIEW_TYPE", "consent": true, "position": "RESPONDER_POSITION", "organization_name": "RESPONDER_ORGANIZATION_NAME", "contact_number": "RESPONDER_PHONE_NUMBER", "photo": "RESPONDER_PHOTO_URL", "other_text": "ANSWER_TO_CUSTOM_FIELD" }, "favourite": false, "created_at": "TIMESTAMP", "updated_at": "TIMESTAMP", "live_mode": true } } ``` ## Object Structure ### User Object The `user` object contains information about the Feedspace user who owns the workspace. ```json theme={null} { "id": "USER_ID", "name": "USER_NAME", "email": "USER_EMAIL", "notification": { "received_text_feed": true, "received_audio_feed": true, "received_video_feed": true }, "custom_domain": { "domain": "CUSTOM_DOMAIN", "status": true, "favicon": "FAVICON_URL" } } ``` #### User Fields * `id`: Unique identifier for the Feedspace user account * `name`: Display name of the Feedspace user * `email`: Email address associated with the Feedspace account * `notification`: Object containing notification preferences * `received_text_feed`: Whether user receives notifications for text reviews * `received_audio_feed`: Whether user receives notifications for audio reviews * `received_video_feed`: Whether user receives notifications for video reviews * `custom_domain`: Object containing custom domain settings * `domain`: Custom domain URL if configured * `status`: Boolean indicating if custom domain is active * `favicon`: URL to custom domain's favicon ### Project Object The `project` object contains information about the workspace/project where the review was submitted. ```json theme={null} { "logo": "LOGO_URL", "name": "PROJECT_NAME", "description": "PROJECT_DESCRIPTION" } ``` #### Project Fields * `logo`: URL to the project's logo image * `name`: Name of the project/workspace * `description`: Description or identifier for the project ### Feed Form Object The `feed_form` object contains information about the review form used to collect the feedback. ```json theme={null} { "id": "FORM_ID", "url": "FORM_URL", "logo": "FORM_LOGO_URL", "name": "FORM_NAME" } ``` #### Feed Form Fields * `id`: Unique identifier for the review form * `url`: Public URL where the form can be accessed * `logo`: URL to the form's logo image * `name`: Name or title of the review form ### Response Object The `response` object contains the actual review data submitted by the user. ```json theme={null} { "Name": "RESPONDER_NAME", "Email": "RESPONDER_EMAIL", "type": "REVIEW_TYPE", "consent": true, "position": "RESPONDER_POSITION", "organization_name": "RESPONDER_ORGANIZATION_NAME", "contact_number": "PHONE_NUMBER", "photo": "PHOTO_URL", "other_text": "ANSWER_TO_CUSTOM_FIELD" } ``` #### Fields * `Name`: Name of the person who submitted the review * `Email`: Email address of the reviewer * `type`: Type of review (e.g., "Audio", "Upload") * `consent`: Whether the reviewer gave consent to share their information * `position`: Position or role of the reviewer * `organization_name`: Name of the organization of the reviewer * `contact_number`: Phone number of the reviewer * `photo`: URL to the reviewer's photo * `other_text`: Answer of the custom field added by the Feedspace user in the feed form settings Note: All fields in this object are customizable. They can be enabled or disabled in the feed form settings. If a field is not enabled in the form settings, it will not be included in the webhook response. ### Top-Level Fields ```json theme={null} { "feed_id": "FEED_ID", "feed_url": "FEED_URL", "audio_url": "AUDIO_FILE_URL", "audio_size": "AUDIO_SIZE_IN_BYTES", "audio_extension": "AUDIO_FILE_EXTENSION", "favourite": false, "created_at": "TIMESTAMP", "updated_at": "TIMESTAMP", "live_mode": true } ``` #### Top-Level Field Descriptions * `feed_id`: Unique identifier for this specific review * `feed_url`: Public URL where the review is accessible * `audio_url`: URL to access the audio file * `audio_size`: Size of the audio file in bytes * `audio_extension`: File extension of the audio (e.g., mp3) * `favourite`: Whether this review is marked as favorite * `created_at`: Timestamp when the review was created * `updated_at`: Timestamp when the review was last updated * `live_mode`: Whether this is a live mode (true) or test mode (false) # Contact us Source: https://docs.feedspace.io/webhook-reference/request # feed.text.received Source: https://docs.feedspace.io/webhook-reference/text-reviews/received This webhook is triggered whenever a new text review is received in your Feedspace account. ## Webhook Type `feed.text.received` ## Payload Format ```json theme={null} { "type": "feed.text.received", "data": { "user": { "id": "USER_ID", "name": "USER_NAME", "email": "USER_EMAIL", "notification": { "received_text_feed": true, "received_audio_feed": true, "received_video_feed": true }, "custom_domain": { "domain": "CUSTOM_DOMAIN", "status": true, "favicon": "FAVICON_URL" } }, "project": { "logo": "LOGO_URL", "name": "PROJECT_NAME", "description": "PROJECT_DESCRIPTION" }, "feed_form": { "id": "FORM_ID", "url": "FORM_URL", "logo": "FORM_LOGO_URL", "name": "FORM_NAME" }, "feed_id": "FEED_ID", "feed_url": "FEED_URL", "response": { "Name": "RESPONDER_NAME", "Email": "RESPONDER_EMAIL", "type": "REVIEW_TYPE", "value": "RESPONSE_VALUE", "comment": "REVIEW_COMMENT", "consent": true, "position": "RESPONDER_POSITION", "organization_name": "RESPONDER_ORGANIZATION_NAME", "contact_number": "RESPONDER_PHONE_NUMBER", "photo": "RESPONDER_PHOTO_URL", "other_text": "ANSWER_TO_CUSTOM_FIELD" }, "favourite": false, "created_at": "TIMESTAMP", "updated_at": "TIMESTAMP", "live_mode": true } } ``` ## Object Structure ### User Object The `user` object contains information about the Feedspace user who owns the workspace. ```json theme={null} { "id": "USER_ID", "name": "USER_NAME", "email": "USER_EMAIL", "notification": { "received_text_feed": true, "received_audio_feed": true, "received_video_feed": true }, "custom_domain": { "domain": "CUSTOM_DOMAIN", "status": true, "favicon": "FAVICON_URL" } } ``` #### User Fields * `id`: Unique identifier for the Feedspace user account * `name`: Display name of the Feedspace user * `email`: Email address associated with the Feedspace account * `notification`: Object containing notification preferences * `received_text_feed`: Whether user receives notifications for text reviews * `received_audio_feed`: Whether user receives notifications for audio reviews * `received_video_feed`: Whether user receives notifications for video reviews * `custom_domain`: Object containing custom domain settings * `domain`: Custom domain URL if configured * `status`: Boolean indicating if custom domain is active * `favicon`: URL to custom domain's favicon ### Project Object The `project` object contains information about the workspace/project where the review was submitted. ```json theme={null} { "logo": "LOGO_URL", "name": "PROJECT_NAME", "description": "PROJECT_DESCRIPTION" } ``` #### Project Fields * `logo`: URL to the project's logo image * `name`: Name of the project/workspace * `description`: Description or identifier for the project ### Feed Form Object The `feed_form` object contains information about the review form used to collect the feedback. ```json theme={null} { "id": "FORM_ID", "url": "FORM_URL", "logo": "FORM_LOGO_URL", "name": "FORM_NAME" } ``` #### Feed Form Fields * `id`: Unique identifier for the review form * `url`: Public URL where the form can be accessed * `logo`: URL to the form's logo image * `name`: Name or title of the review form ### Response Object The `response` object contains the actual review data submitted by the user. ```json theme={null} { "Name": "RESPONDER_NAME", "Email": "RESPONDER_EMAIL", "type": "REVIEW_TYPE", "value": "RESPONSE_VALUE", "comment": "REVIEW_COMMENT", "consent": true, "position": "RESPONDER_POSITION", "organization_name": "RESPONDER_ORGANIZATION_NAME", "contact_number": "PHONE_NUMBER", "photo": "PHOTO_URL", "other_text": "ANSWER_TO_CUSTOM_FIELD" } ``` #### Fields * `Name`: Name of the person who submitted the review * `Email`: Email address of the reviewer * `type`: Type of review (e.g., "thumbs\_up", "star", "comment\_only") * `value`: Value corresponding to the review type * For `type` "thumbs\_up": `true` = upvote, `false` = downvote * For `type` "star": 1-5 rating scale * For `type` "comment\_only": `value` will be `null` * `comment`: The actual text content of the review * `consent`: Whether the reviewer gave consent to share their information * `position`: Position or role of the reviewer * `organization_name`: Name of the organization of the reviewer * `contact_number`: Phone number of the reviewer * `photo`: URL to the reviewer's photo * `other_text`: Answer of the custom field added by the Feedspace user in the feed form settings Note: All fields in this object are customizable. They can be enabled or disabled in the feed form settings. If a field is not enabled in the form settings, it will not be included in the webhook response. ### Top-Level Fields ```json theme={null} { "feed_id": "FEED_ID", "feed_url": "FEED_URL", "favourite": false, "created_at": "TIMESTAMP", "updated_at": "TIMESTAMP", "live_mode": true } ``` #### Top-Level Field Descriptions * `feed_id`: Unique identifier for this specific review * `feed_url`: Public URL where the review is accessible * `favourite`: Whether this review is marked as favorite * `created_at`: Timestamp when the review was created * `updated_at`: Timestamp when the review was last updated * `live_mode`: Whether this is a live mode (true) or test mode (false) # feed.video.received Source: https://docs.feedspace.io/webhook-reference/video-reviews/received This webhook is triggered whenever a new video review is received in your Feedspace account. ## Webhook Type `feed.video.received` ## Payload Format ```json theme={null} { "type": "feed.video.received", "data": { "user": { "id": "USER_ID", "name": "USER_NAME", "email": "USER_EMAIL", "notification": { "received_text_feed": true, "received_audio_feed": true, "received_video_feed": true }, "custom_domain": { "domain": "CUSTOM_DOMAIN", "status": true, "favicon": "FAVICON_URL" } }, "project": { "logo": "LOGO_URL", "name": "PROJECT_NAME", "description": "PROJECT_DESCRIPTION" }, "feed_form": { "id": "FORM_ID", "url": "FORM_URL", "logo": "FORM_LOGO_URL", "name": "FORM_NAME" }, "feed_id": "FEED_ID", "feed_url": "FEED_URL", "video_url": "VIDEO_FILE_URL", "thumbnail_url": "THUMBNAIL_IMAGE_URL", "video_size": "VIDEO_SIZE_IN_BYTES", "video_extension": "VIDEO_FILE_EXTENSION", "response": { "Name": "RESPONDER_NAME", "Email": "RESPONDER_EMAIL", "type": "REVIEW_TYPE", "consent": true, "position": "RESPONDER_POSITION", "organization_name": "RESPONDER_ORGANIZATION_NAME", "contact_number": "RESPONDER_PHONE_NUMBER", "photo": "RESPONDER_PHOTO_URL", "other_text": "ANSWER_TO_CUSTOM_FIELD" }, "favourite": false, "created_at": "TIMESTAMP", "updated_at": "TIMESTAMP", "live_mode": true } } ``` ## Object Structure ### User Object The `user` object contains information about the Feedspace user who owns the workspace. ```json theme={null} { "id": "USER_ID", "name": "USER_NAME", "email": "USER_EMAIL", "notification": { "received_text_feed": true, "received_audio_feed": true, "received_video_feed": true }, "custom_domain": { "domain": "CUSTOM_DOMAIN", "status": true, "favicon": "FAVICON_URL" } } ``` #### User Fields * `id`: Unique identifier for the Feedspace user account * `name`: Display name of the Feedspace user * `email`: Email address associated with the Feedspace account * `notification`: Object containing notification preferences * `received_text_feed`: Whether user receives notifications for text reviews * `received_audio_feed`: Whether user receives notifications for audio reviews * `received_video_feed`: Whether user receives notifications for video reviews * `custom_domain`: Object containing custom domain settings * `domain`: Custom domain URL if configured * `status`: Boolean indicating if custom domain is active * `favicon`: URL to custom domain's favicon ### Project Object The `project` object contains information about the workspace/project where the review was submitted. ```json theme={null} { "logo": "LOGO_URL", "name": "PROJECT_NAME", "description": "PROJECT_DESCRIPTION" } ``` #### Project Fields * `logo`: URL to the project's logo image * `name`: Name of the project/workspace * `description`: Description or identifier for the project ### Feed Form Object The `feed_form` object contains information about the review form used to collect the feedback. ```json theme={null} { "id": "FORM_ID", "url": "FORM_URL", "logo": "FORM_LOGO_URL", "name": "FORM_NAME" } ``` #### Feed Form Fields * `id`: Unique identifier for the review form * `url`: Public URL where the form can be accessed * `logo`: URL to the form's logo image * `name`: Name or title of the review form ### Response Object The `response` object contains the actual review data submitted by the user. ```json theme={null} { "Name": "RESPONDER_NAME", "Email": "RESPONDER_EMAIL", "type": "REVIEW_TYPE", "consent": true, "position": "RESPONDER_POSITION", "organization_name": "RESPONDER_ORGANIZATION_NAME", "contact_number": "PHONE_NUMBER", "photo": "PHOTO_URL", "other_text": "ANSWER_TO_CUSTOM_FIELD" } ``` #### Fields * `Name`: Name of the person who submitted the review * `Email`: Email address of the reviewer * `type`: Type of review (e.g., "Video", "Screen", "Upload") * `consent`: Whether the reviewer gave consent to share their information * `position`: Position or role of the reviewer * `organization_name`: Name of the organization of the reviewer * `contact_number`: Phone number of the reviewer * `photo`: URL to the reviewer's photo * `other_text`: Answer of the custom field added by the Feedspace user in the feed form settings Note: All fields in this object are customizable. They can be enabled or disabled in the feed form settings. If a field is not enabled in the form settings, it will not be included in the webhook response. ### Top-Level Fields ```json theme={null} { "feed_id": "FEED_ID", "feed_url": "FEED_URL", "video_url": "VIDEO_FILE_URL", "thumbnail_url": "THUMBNAIL_IMAGE_URL", "video_size": "VIDEO_SIZE_IN_BYTES", "video_extension": "VIDEO_FILE_EXTENSION", "favourite": false, "created_at": "TIMESTAMP", "updated_at": "TIMESTAMP", "live_mode": true } ``` #### Top-Level Field Descriptions * `feed_id`: Unique identifier for this specific review * `feed_url`: Public URL where the review is accessible * `video_url`: URL to access the video file * `thumbnail_url`: URL to the video thumbnail image * `video_size`: Size of the video file in bytes * `video_extension`: File extension of the video (e.g., mp4) * `favourite`: Whether this review is marked as favorite * `created_at`: Timestamp when the review was created * `updated_at`: Timestamp when the review was last updated * `live_mode`: Whether this is a live mode (true) or test mode (false) # Getting Started Source: https://docs.feedspace.io/webhook-reference/webhook-access Feedspace provides webhooks to notify your application about important events in real-time. This section documents all available webhook events and their payloads. ### How to Get Webhook Access To get webhook access: 1. Go to the [Webhook Access](https://app.feedspace.io/automation/webhooks) page in your Feedspace account. 2. Enter your webhook endpoint URL in the provided input field. 3. After adding your endpoint URL, you can select which events you want to receive notifications for. 4. Click the "Activate" button to enable webhook access for your account. Once activated, Feedspace will start sending webhook notifications for the selected events to your specified endpoint. ### Available Webhook Events Feedspace currently supports the following webhook events: * `feed.text.received`: Triggered when a new text review is received * `feed.video.received`: Triggered when a new video review is received * `feed.audio.received`: Triggered when a new audio review is received ### Webhook Delivery Feedspace will send webhook notifications as HTTP POST requests to your specified webhook URL. Each notification follows this format: ```json theme={null} { "type": "event type", "data": { // Event-specific data } } ``` The notification contains: * `type`: The event type (e.g., "feed.text.received", "feed.video.received", "feed.audio.received") * `data`: The event-specific data payload ### Example Request When a new text review is received, Feedspace will send a POST request to your webhook URL with a payload like this: ```json theme={null} { "event": "feed.text.received", "data": { ... } } ``` ## Verify Webhook Signature To ensure the integrity and authenticity of incoming webhook requests, Feedspace signs each payload with a unique secret. We strongly recommend verifying this signature for all production webhooks. ### How It Works 1. **The Signature Headers:** Feedspace sends two headers with each webhook request: * `x-feedspace-signature`: The HMAC-SHA256 signature of the payload. * `x-feedspace-timestamp`: The Unix timestamp (in seconds) when the webhook was sent 2. **Your Signing Secret:** Each webhook in your workspace has a unique signing secret. You can find this secret in your Feedspace dashboard under **Automation > Webhook**. Secrets are prefixed with `whsec_`. 3. **Verification Process:** You reconstruct the signature on your server using the timestamp, the raw request body, and your secret. If it matches the `x-feedspace-signature` header, the webhook is legitimate. ### Sample Verification Code ```php PHP theme={null} ### Best Practices * Implement proper error handling for incoming webhook requests * Consider implementing request validation to verify the authenticity of webhook requests * Handle different event types appropriately in your application * Keep your webhook endpoint URL secure and accessible