FAQ & widgets

Account self-service: company FAQ blocks, testimonials, gallery images, and review widgets.

Account self-service: company FAQ blocks, testimonials, gallery images, and review widgets.

Prerequisites

  • A bearer token in the Authorization header. Any endpoint that needs no token says so on its own page.
  • The id of each record the call targets. Every endpoint page lists the ids it needs.

Errors

StatusMeaning
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Individual endpoints may return more; each page lists its own.

Endpoints

List child accounts

GET — Get the immediate child companies (accounts/locations) directly under the authenticated user's own company, formatted as value/label option pairs for dropdowns.

Open →

Overall ranking by location (last 12 months)

GET — Overall location ranking for the selected window (default last 12 months): up to 10 store locations ranked and graded by review count, response rate, and average rating (for hipages stores, spanning reviews from all connected sites).

Open →

Get FAQ list

GET — Get the FAQ entries for a company, optionally filtered by type and status.

Open →

Get how-it-works blocks

GET — Get the 'how it works' blocks for a company, filtered by type.

Open →

Get testimonials

GET — Get the testimonials configured for a company.

Open →

Save how-it-works block

POST — Replace the 'how it works' blocks for a company.

Open →

Save FAQ entries

POST — Replace the FAQ entries for a company.

Open →

Save testimonials

POST — Replace the testimonials for a company.

Open →

Get images

GET — Get the active images uploaded for a company, filtered by type.

Open →

Save images (upload)

POST — Upload one or more image files to S3 (under account/images/{type}) and creates an Image row per file for the company, returning the saved records with public S3 URLs.

Open →

Delete image

DELETE — Delete a stored company image.

Open →

List widgets

POST — Returns a paginated list of widgets scoped to a single store (store_id) or an account company and its child companies (company_id), joined to widget type, store, and company-account names, with optional search/sort.

Open →

Create or update widget

POST — Create a new widget, or updates an existing one when you supply unique_id.

Open →

Delete widget

DELETE — Permanently deletes a widget identified by its unique_id.

Open →


Did this page help you?