Create a new testimonial programmatically via the NOW.TS API
Create a new testimonial in your organization. Testimonials can be text, video, or audio format.
POST /v1/testimonials
This endpoint requires authentication. Include your API token in the Authorization header:
Authorization: Bearer YOUR_API_TOKEN
| Field | Type | Required | Description |
|---|---|---|---|
content | string | Yes | The testimonial content (min 10 characters) |
author | object | Yes | Author information |
author.name | string | Yes | Author's full name |
author.email | string | Yes | Author's email address |
author.company | string | No | Author's company name |
rating | number | No | Rating from 1-5 stars |
type | string | Yes | Testimonial type: text, video, or audio |
tags | array | No | Array of tags for categorization |
Returns a testimonial object with the following fields:
| Field | Type | Description |
|---|---|---|
id | string | Unique testimonial identifier |
content | string | The testimonial content |
author | object | Author information |
rating | number | Rating from 1-5 stars |
type | string | Testimonial type |
status | string | Current status: pending, approved, rejected |
createdAt | string | ISO 8601 timestamp of creation |
updatedAt | string | ISO 8601 timestamp of last update |
| Code | Description |
|---|---|
400 | Bad Request - Invalid request data |
401 | Unauthorized - Invalid or missing API token |
403 | Forbidden - Insufficient permissions |
422 | Validation Error - Request data failed validation |
500 | Internal Server Error - Something went wrong on our end |