Skip to main content
POST
cURL

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.