Skip to main content
POST
Import an audio review

Authorizations

Authorization
string
header
required

HTTP Basic Authentication using API Key and Secret Key. The credentials should be Base64 encoded in the format 'api_key:secret_key'. You can obtain your API Key and Secret Key from Feedspace → Automation → API (https://app.feedspace.io/automation/api).

Body

multipart/form-data

Request body for importing an audio review manually. 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.

customer_avatar
file

Customer avatar image (optional). Allowed formats: jpeg, png, jpg, gif, svg, webp, bmp, avif. Max size: 15 MB

customer_name
string

Customer name (optional)

Maximum string length: 255
customer_email
string<email>

Customer email (optional, must be valid email format)

Maximum string length: 255
customer_designation
string

Customer designation/job title (optional)

Maximum string length: 255
customer_company
string

Customer company name (optional)

Maximum string length: 255
customer_company_url
string

Customer company website URL (optional). The scheme is optional, so a bare domain such as example.com is accepted.

Maximum string length: 255

Customer company logo image (optional). Allowed formats: jpeg, png, jpg, gif, svg, webp, bmp, avif. Max size: 15 MB

rating
number

Rating value (0 = lowest, 5 = highest, optional). Decimal values such as 4.5 are accepted.

Required range: 0 <= x <= 5
review_url
string<uri>

Review source URL (optional)

Maximum string length: 255
review
string

Review text content (optional)

review_at
string<date>

Date when the review was submitted (YYYY-MM-DD format, optional)

Website logo image (optional). Allowed formats: jpeg, png, jpg, gif, svg, webp, bmp, avif. Max size: 15 MB

type
string

Import mode. Use 'file' to upload audio files via attachments[]; omit or use another value to reference previously uploaded Feedspace media via attachment_urls[] (optional).

attachments[]
file | null

Audio files (required if type='file'). Must be valid audio files (audio mime types).

attachment_urls[]
string<uri> | null

Feedspace-hosted media URLs for the audio (required when type is not 'file'). Each must be a URL returned by a prior Feedspace upload; arbitrary external URLs are rejected.

Response

200 - application/json

Audio review imported successfully.

This endpoint also returns 200 when the import fails. In that case the body is { "data": { "error": "Failed to store reviews." } } instead of the imported review, so check for a data.error key rather than relying on the status code alone.

The response is of type object.