> ## Documentation Index
>
> Fetch the complete documentation index at: https://testimonial.to/guide/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://testimonial.to/dashboard). On the Space card, click the **3-dot** icon and choose **API key**.

![](https://apuqtiwclzoqhluvxsdm.supabase.co/storage/v1/object/public/help-center/3d/3d8eaf78b1b9e7a0011c9d02e0d5c6c5.png)

In the popup, click **Copy API Key**.

![](https://apuqtiwclzoqhluvxsdm.supabase.co/storage/v1/object/public/help-center/3d/3d594830a4a9f01c973f685dd5164600.png)

See also [API - How to get your API KEY](https://help.testimonial.to/en/articles/6814418-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](https://help.testimonial.to/en/articles/6451677-api-submit-a-text-testimonial) · [API - GET all testimonials](https://help.testimonial.to/en/articles/6223143-api-get-all-testimonials)

Need help? Message us in the chat widget.