API - Submit a video testimonial

Submit a video testimonial with POST /v1/submit/video and your Space API key. Optionally add it to the Wall of Love.

Submit a video testimonial with a POST request to https://api.testimonial.to/v1/submit/video. Send your Space API key in the Authorization: Bearer API_KEY header. You can also add the video to your Wall of Love in the same request.

Make a request

Replace API_KEY with your Space API key. Replace the example name and email with the submitter’s details.

curl --location --request POST 'https://api.testimonial.to/v1/submit/video' \--header 'Authorization: Bearer API_KEY' \--header 'Content-Type: application/json' \--data-raw '{    "videoURL": "https://s3.amazonaws.com/leds.mp4",    "name": "Jordan Hale",    "email": "jordan@example.com",    "isLiked": true // default is false}'

Parameters

Two parameters are required:

  1. videoURL — a publicly accessible video URL

  2. name — the submitter’s name

Optional parameters:

  1. email — the submitter’s email

  2. title — the submitter’s title and company

  3. socialLink — the submitter’s social profile link (for example, a LinkedIn URL)

  4. confirm — whether the submitter permits public use of the video. false by default

  5. isLiked — add the video to the Wall of Love. false by default

Get your API key

Open the dashboard. On the Space card, click the 3-dot icon and choose API key.

In the popup, click Copy API Key.

See also API - How to get your API KEY.

Return value

A successful request returns status success and message The video is uploaded successfully.

A failed request returns status failed and a message that explains why.

{    "status": "failed",    "message": "Video URL is required! Please add videoURL in the URL query string."}

Related: API - Submit a text testimonial · API - GET all testimonials

Need help? Message us in the chat widget.

PreviousAPI - Submit a text testimonial
API - Submit a video testimonial | Testimonial