API/Create Testimonial

Create Testimonial

Create a new testimonial programmatically via the NowStack API

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