All Collections
Automation & APIs
API
API - Submit a video testimonial
API - Submit a video testimonial
Damon Chen avatar
Written by Damon Chen
Updated over a week ago

You can submit a video testimonial via a POST request to your Testimonial space, and even add it to your Wall of Love directly.

API syntax

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": "Damon Chen",
"email": "[email protected]",
"isLiked": true, // default is false
}'

Parameters

Two parameters are required:

  1. videoURL (publicly accessible video URL)

  2. name (submitter's name)

Here are some optional parameters you can use too:

  1. email (submitter's email)

  2. title (submitter's title and company)

  3. socialLink (submitter's social profile link, i.e. LinkedIn profile link)

  4. confirm (whether submitter permits to use his/her video publicly, false by default)

  5. isLiked (directly add the video to the Wall of Love, false by default)

How to get the API_KEY

You need to go to the dashboard page. On the right side of each space card, there is a โš™๏ธ icon, click that you will see a dropdown list, choose the API key

notion image

You will see a popup modal show your API key, click Copy API Key to copy the key

notion image

Return value

Upon a successful request, the status will show success, and message will say The video is uploaded successfully.

If the request failed, the status will show failed, and the message will display the reason why it failed.

{
"status": "failed",
"message": "Video URL is required! Please add videoURL in the URL query string."
}
Did this answer your question?