app logoNOW.TS

Create Testimonial

Create a new testimonial in your organization. Testimonials can be text, video, or audio format.

Endpoint

POST /v1/testimonials

Authentication

This endpoint requires authentication. Include your API token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Request Body

FieldTypeRequiredDescription
contentstringYesThe testimonial content (min 10 characters)
authorobjectYesAuthor information
author.namestringYesAuthor's full name
author.emailstringYesAuthor's email address
author.companystringNoAuthor's company name
ratingnumberNoRating from 1-5 stars
typestringYesTestimonial type: text, video, or audio
tagsarrayNoArray of tags for categorization

Response

Returns a testimonial object with the following fields:

FieldTypeDescription
idstringUnique testimonial identifier
contentstringThe testimonial content
authorobjectAuthor information
ratingnumberRating from 1-5 stars
typestringTestimonial type
statusstringCurrent status: pending, approved, rejected
createdAtstringISO 8601 timestamp of creation
updatedAtstringISO 8601 timestamp of last update

Error Codes

CodeDescription
400Bad Request - Invalid request data
401Unauthorized - Invalid or missing API token
403Forbidden - Insufficient permissions
422Validation Error - Request data failed validation
500Internal Server Error - Something went wrong on our end

Request

curl -X POST https://api.nowts.com/v1/testimonials \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Amazing product! Highly recommend to everyone.",
    "author": {
      "name": "John Doe",
      "email": "john@example.com",
      "company": "Acme Corp"
    },
    "rating": 5,
    "type": "text"
  }'

Results

{
  "id": "test_123456789",
  "content": "Amazing product! Highly recommend to everyone.",
  "author": {
    "name": "John Doe",
    "email": "john@example.com",
    "company": "Acme Corp"
  },
  "rating": 5,
  "type": "text",
  "status": "pending",
  "createdAt": "2025-08-22T10:30:00Z",
  "updatedAt": "2025-08-22T10:30:00Z"
}
PrivacyTermsapp icon