# Feedspace API Documentation

- [Authentication](https://docs.feedspace.io/api-reference/authentication.md)
- [Responses](https://docs.feedspace.io/api-reference/responses.md): The status codes the Feedspace API returns, the shape of each response body, and what to do about them.
- [List All Reviews](https://docs.feedspace.io/api-reference/Feeds/list-feeds.md): Get a paginated list of reviews 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-from…
- [All Audio Reviews](https://docs.feedspace.io/api-reference/AudioReviews/all-audio-reviews.md): Get a paginated list of reviews 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-from…
- [Single Audio Review](https://docs.feedspace.io/api-reference/AudioReviews/single-audio-review.md): Get details of a specific audio review by its ID.
- [Update Audio Review](https://docs.feedspace.io/api-reference/AudioReviews/edit-audio-review.md): Edit a specific audio review.
- [Delete Audio Review](https://docs.feedspace.io/api-reference/AudioReviews/soft-delete.md): Delete a specific audio review from the list.
- [All Video Reviews](https://docs.feedspace.io/api-reference/VideoReviews/all-video-reviews.md): Get a paginated list of reviews 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-from…
- [Single Video Review](https://docs.feedspace.io/api-reference/VideoReviews/single-video-review.md): Get details of a single Video Review.
- [Update Video Review](https://docs.feedspace.io/api-reference/VideoReviews/edit-video-review.md): Edit a specific video review.
- [Delete Video Review](https://docs.feedspace.io/api-reference/VideoReviews/soft-delete.md): Delete a specific video review from the list.
- [All Text Reviews](https://docs.feedspace.io/api-reference/TextReviews/all-text-reviews.md): Get a paginated list of reviews 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-from…
- [Single Text Review](https://docs.feedspace.io/api-reference/TextReviews/single-text-review.md): Get details of a specific text review by its ID.
- [Update Text Review](https://docs.feedspace.io/api-reference/TextReviews/edit-text-review.md): Edit a specific text review.
- [Delete Text Review](https://docs.feedspace.io/api-reference/TextReviews/soft-delete.md): Delete a specific text review from the list.
- [All Social Reviews](https://docs.feedspace.io/api-reference/SocialReviews/all-social-reviews.md): Get a paginated list of reviews 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-from…
- [Single Social Review](https://docs.feedspace.io/api-reference/SocialReviews/single-social-review.md): Get details of a specific social review by its ID. Social reviews are testimonials imported from social platforms (G2, Trustpilot, Product Hunt, etc.) and manual or web-link imports that are stored as social records.
- [Delete Social Review](https://docs.feedspace.io/api-reference/SocialReviews/soft-delete.md): Delete a specific social review from the list. This is a soft delete.
- [All Pages](https://docs.feedspace.io/api-reference/WallOfLove/all-pages.md): Get all pages.
- [Create Page](https://docs.feedspace.io/api-reference/WallOfLove/create-page.md): Create a new page.
- [Get All Reviews (Pages)](https://docs.feedspace.io/api-reference/WallOfLove/get-reviews.md): Get all reviews for pages, with filters for review types, favourite, forms, imported sources, sentiments, ratings, labels, and search.
- [Get Selected Reviews](https://docs.feedspace.io/api-reference/WallOfLove/selected-feeds.md): Get review details for selected review identifiers. This endpoint accepts an array of review identifiers and returns the corresponding review details formatted for pages.
- [Update Page](https://docs.feedspace.io/api-reference/WallOfLove/update-page.md): Update an existing page. Send the body as `multipart/form-data` using a `POST` request with a `_method=PUT` field.
- [Create Review Form](https://docs.feedspace.io/api-reference/ReviewForms/create-form.md): Creates a new review form.
- [Update Review Form](https://docs.feedspace.io/api-reference/ReviewForms/update-form.md): Updates an existing review form by its `unique_form_id`.
- [Get Review Form](https://docs.feedspace.io/api-reference/ReviewForms/get-form.md): Returns a single review form by its `unique_form_id`.
- [Get All Review Form](https://docs.feedspace.io/api-reference/ReviewForms/get-all-forms.md): Returns a list of all review forms.
- [Delete Review Form](https://docs.feedspace.io/api-reference/ReviewForms/delete-form.md): Permanently deletes a review form by its `unique_form_id`.
- [List Review Labels](https://docs.feedspace.io/api-reference/Labels/list-labels.md): 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.
- [Import Text Review](https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/import-text-review.md): 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](https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/import-video-review.md): 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[]` is required.
- [Import Audio Review](https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/import-audio-review.md): Import an audio review manually into the workspace. All fields are optional. If `type` is 'file', then `attachments[]` (audio files) is required. If `type` is not 'file' or omitted, then `attachment_urls[]` is required.
- [Import from Web Link](https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/import-web-link.md): Import Reviews from Web Link. Enter the web link url from where you want to import reviews into Feedspace.
- [Screenshot to Review](https://docs.feedspace.io/api-reference/ImportReviews/SelfImport/screenshot-to-review.md): Screenshot to Review. Upload a screenshot of your review to automatically import it.
- [List Contacts](https://docs.feedspace.io/api-reference/Contacts/list-contacts.md): List contacts in the workspace. Contacts power Feedspace's email automation and are commonly synced from external platforms (Zapier, Pabbly, Make, n8n). Requires the workspace's plan/role to include email automation.
- [Create or Update Contact](https://docs.feedspace.io/api-reference/Contacts/create-contact.md): Create or update a contact. This is an **upsert keyed on email** (within the workspace): if a contact with the same email exists it is updated, otherwise it is created. On an existing contact, scalar fields are only filled where they are currently empty (customer-entered values are preserved), and t…
- [Get Contact](https://docs.feedspace.io/api-reference/Contacts/get-contact.md): Get a single contact plus its activity timeline.
- [Update Contact](https://docs.feedspace.io/api-reference/Contacts/update-contact.md): Update a contact's profile fields. Only the fields you send are changed. Email, source, and subscription state cannot be changed here (use the upsert for email, and the unsubscribe endpoint for subscription state).
- [Delete Contact](https://docs.feedspace.io/api-reference/Contacts/delete-contact.md): Delete a contact. This is a soft delete.
- [Unsubscribe Contact](https://docs.feedspace.io/api-reference/Contacts/unsubscribe-contact.md): Unsubscribe a contact from email automation. Idempotent: if the contact is already unsubscribed, the existing reason and timestamp are kept.
- [Assign Tags to Contact](https://docs.feedspace.io/api-reference/Contacts/assign-tags.md): Assign one or more tags to a contact. Idempotent — tags already present are left as-is.
- [Remove Tags from Contact](https://docs.feedspace.io/api-reference/Contacts/unassign-tags.md): Remove one or more tags from a contact. Send the tag IDs in the request body.
- [List Contact Tags](https://docs.feedspace.io/api-reference/ContactTags/list-tags.md): List all contact tags in the workspace, each with the number of contacts carrying it.
- [Create Contact Tag](https://docs.feedspace.io/api-reference/ContactTags/create-tag.md): Create a contact tag. Tag names must be unique within the workspace.
- [Update Contact Tag](https://docs.feedspace.io/api-reference/ContactTags/update-tag.md): Update a contact tag. Only the fields you send are changed; sending `color: null` does not clear it.
- [Delete Contact Tag](https://docs.feedspace.io/api-reference/ContactTags/delete-tag.md): Delete a contact tag. Its assignments to contacts are removed automatically.
- [Getting Started](https://docs.feedspace.io/webhook-reference/webhook-access.md)
- [feed.text.received](https://docs.feedspace.io/webhook-reference/text-reviews/received.md)
- [feed.video.received](https://docs.feedspace.io/webhook-reference/video-reviews/received.md)
- [feed.audio.received](https://docs.feedspace.io/webhook-reference/audio-reviews/received.md)
- [Contact us](https://docs.feedspace.io/webhook-reference/request.md)
- [Product Updates](https://docs.feedspace.io/changelog/product-updates.md): Feedspace is constantly evolving. See what’s new and improved.
- [Feedspace MCP Server](https://docs.feedspace.io/mcp/overview.md): Connect AI tools like ChatGPT, Claude, and Perplexity to your Feedspace reviews and testimonials using the Model Context Protocol.
- [Setup & Installation](https://docs.feedspace.io/mcp/setup.md): Connect the Feedspace MCP server to ChatGPT, Claude, Perplexity, Lovable, Bolt, or v0.
- [ChatGPT](https://docs.feedspace.io/mcp/setup/chatgpt.md): Add Feedspace to ChatGPT with the Feedspace app or a custom MCP connector.
- [Claude](https://docs.feedspace.io/mcp/setup/claude.md): Add Feedspace to Claude as a custom connector for AI-powered review workflows.
- [Perplexity](https://docs.feedspace.io/mcp/setup/perplexity.md): Authorize Feedspace inside Perplexity to query your reviews from chat.
- [Lovable](https://docs.feedspace.io/mcp/setup/lovable.md): Connect Feedspace to Lovable so your prompts can pull live reviews.
- [Bolt](https://docs.feedspace.io/mcp/setup/bolt.md): Use Feedspace data while building inside Bolt with a custom MCP server.
- [v0](https://docs.feedspace.io/mcp/setup/v0.md): Reference Feedspace tools while iterating on your v0 designs.
- [Reviews](https://docs.feedspace.io/mcp/tools/reviews.md): Tools for managing reviews and testimonials in your Feedspace workspace.
- [Forms](https://docs.feedspace.io/mcp/tools/forms.md): Tools for creating and managing review collection forms.
- [Widgets](https://docs.feedspace.io/mcp/tools/widgets.md): Tools for creating embeddable testimonial widgets for your website.
- [Wall of Love](https://docs.feedspace.io/mcp/tools/pages.md): Tools for creating standalone testimonial pages with shareable URLs.
- [Labels](https://docs.feedspace.io/mcp/tools/labels.md): Tools for organizing reviews with labels.
- [Workspaces](https://docs.feedspace.io/mcp/tools/workspaces.md): Tools for managing Feedspace workspaces.
- [Team Members](https://docs.feedspace.io/mcp/tools/team-members.md): Tools for managing workspace team members and invitations.
- [Imports](https://docs.feedspace.io/mcp/tools/imports.md): Tools for importing reviews into Feedspace.
- [Use Cases & Examples](https://docs.feedspace.io/mcp/examples.md): Copy-paste prompts and worked end-to-end examples for the Feedspace MCP server.
- [Troubleshooting & FAQ](https://docs.feedspace.io/mcp/troubleshooting.md): Common issues and solutions when using the Feedspace MCP server.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)