Create a review

POST https://api.tamio.com/v2/reviews/create

Creates a new product review with a star rating, text content, and reviewer name. Optionally attach an image (by asset UUID), set a custom creation timestamp, flag as a verified customer review, or add external references.

Body Parameters

product string*

UUID of the product being reviewed.

rating integer*

Star rating (0–5).

review_text string*

Main review content.

name string*

Name of the reviewer.

image string

UUID of an image asset to attach, or null for no image.

customer_review boolean

Whether this is a verified customer review.

created_at string

Custom creation timestamp (ISO 8601 string or Unix timestamp as string, up to 26 characters).

external_review string

URL to an external review document or image (PDF or image URL).

external_link string

External URL related to the review.

Responses

200 Review created

Review created

status integer

reviews Review

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Product not found or image asset not found

status integer

error string

error_code integer

401 Missing or invalid API key

List all reviews

Update a review

/reviews/create

1 const response = await fetch("https://api.tamio.com/v2/reviews/create", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "product": "123e4567-e89b-12d3-a456-426614174000",
9     "rating": 5,
10     "review_text": "Excellent product, highly recommended!",
11     "name": "John Doe",
12     "image": "aaa14567-e89b-12d3-a456-426614174000",
13     "customer_review": true,
14     "created_at": "2024-06-15T10:30:00Z",
15     "external_review": "https://example.com/review-screenshot.png",
16     "external_link": "https://trustpilot.com/review/abc123"
17   })
18 });
19 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/reviews/create")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   product: "123e4567-e89b-12d3-a456-426614174000",
16   rating: 5,
17   review_text: "Excellent product, highly recommended!",
18   name: "John Doe",
19   image: "aaa14567-e89b-12d3-a456-426614174000",
20   customer_review: true,
21   created_at: "2024-06-15T10:30:00Z",
22   external_review: "https://example.com/review-screenshot.png",
23   external_link: "https://trustpilot.com/review/abc123"
24 }.to_json
25 
26 response = https.request(request)
27 puts response.read_body

Responses

{
  "status": 200,
  "reviews": {
    "id": "999e4567-e89b-12d3-a456-426614174000",
    "object": "review",
    "name": "John Doe",
    "locale": "en",
    "review_text": "Excellent product, highly recommended!",
    "rating": 5,
    "created_at": 1718444400,
    "image": "https://cdn.tamio.com/assets/review-photo.jpg",
    "external_review": "https://example.com/review-screenshot.png",
    "external_link": "https://trustpilot.com/review/abc123",
    "product": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Premium Widget"
    },
    "customer": {
      "id": "223e4567-e89b-12d3-a456-426614174000",
      "name": "Jane Smith",
      "email": "[email protected]"
    },
    "customer_review": true,
    "invoice": {
      "prefix": "INV",
      "number": 1042,
      "date_bought": 1717000000
    }
  }
}

1	const response = await fetch("https://api.tamio.com/v2/reviews/create", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"product": "123e4567-e89b-12d3-a456-426614174000",
9	"rating": 5,
10	"review_text": "Excellent product, highly recommended!",
11	"name": "John Doe",
12	"image": "aaa14567-e89b-12d3-a456-426614174000",
13	"customer_review": true,
14	"created_at": "2024-06-15T10:30:00Z",
15	"external_review": "https://example.com/review-screenshot.png",
16	"external_link": "https://trustpilot.com/review/abc123"
17	})
18	});
19	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/reviews/create")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	product: "123e4567-e89b-12d3-a456-426614174000",
16	rating: 5,
17	review_text: "Excellent product, highly recommended!",
18	name: "John Doe",
19	image: "aaa14567-e89b-12d3-a456-426614174000",
20	customer_review: true,
21	created_at: "2024-06-15T10:30:00Z",
22	external_review: "https://example.com/review-screenshot.png",
23	external_link: "https://trustpilot.com/review/abc123"
24	}.to_json
25
26	response = https.request(request)
27	puts response.read_body