Save testimonials

Overview

Replace the testimonials for an account. In a single DB transaction, it deletes every existing block with type = "testimonials" for the given company_id. It then inserts the supplied testimonials, each saved with type = "testimonials" and status = "active".

Prerequisites

• A bearer token. Callable with Partner and Account tokens.

Base URL

Endpoint

POST /api/v1/account/faq/testimonials

Authentication

• Requires a bearer token in the Authorization: Bearer <bearer-token> header.

• Who can call it: Partner and Account tokens.

• Target company comes from the company_id body field. There is no ownership/partner-tree scoping, so any authenticated Partner or Account user can write testimonials for any company id.

• Role only changes which company_id you pass.

Rate limit

• No rate limit.

Request body

• Body:

{
  "company_id": 42,
  "testimonials": [
    {
      "content": "<p>Great service, highly recommend!</p>"
    },
    {
      "content": "<p>The team was fantastic.</p>"
    }
  ]
}

Response

• data.status (string) — literal "success".
• data.message (string) — "Testimonials saved successfully".

200 OK · 200

{
  "data": {
    "status": "success",
    "message": "Testimonials saved successfully"
  }
}

422 Validation error · 422

{
  "message": "The testimonials field is required.",
  "errors": {
    "testimonials": ["The testimonials field is required."]
  }
}

Errors

Example request

curl --request POST \
  --url "https://production-api.shoutaboutus.com/api/v1/account/faq/testimonials" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"company_id": 42, "testimonials": [{"content": "<p>Great service, highly recommend!</p>"}, {"content": "<p>The team was fantastic.</p>"}]}'