# Access to Synthesia's API

Welcome to Synthesia's API documentation. If it's your first time using Synthesia API, follow the [API quickstart](https://docs.synthesia.io/reference/synthesia-api-quickstart) guide.

Leveraging Synthesia's API allows you to:

- **Integrate Synthesia with your SaaS applications**: Do you have an email app for outbound sales? A booking system? A modern e-learning platform? Enrich your application by adding the ability for your customers to send personalized videos based on different events with Synthesia's API.
- **Automate your video creation process**: Set up automated personalized videos throughout your customer lifecycle (i.e. automate the creation of sign-up, customer onboarding, and outbound sales videos).

Check out the [Zapier - Synthesia](https://docs.synthesia.io/reference/guide-synthesia-zapier) guide to get started.
- **Generate personalized videos at scale**: Leverage Synthesia video templates with the APIs to generate batches of video. Learn how to by checking the [Create a video from template guide](https://docs.synthesia.io/reference/guide-create-a-video-from-template).

## Testing

> ⚠️  
> **Rate Limit for Test Videos** — You're limited to 30 test videos per day.

To send a test request directly from our documentation:

1. Add your Synthesia API key to the Authorization header.

You can find your existing API keys, or create a new one, from [account settings](https://app.synthesia.io/#/account).
2. Use the endpoint description to craft your request.
3. Click on `Try it!` 🚀

## Rate limits

Rate limits vary based on your payment plan:

| API Tier | Write Operations (per endpoint) | Read Operations (per endpoint) |
| --- | --- | --- |
| Tier 1 (Enterprise) | 120 req/min \| 600 req/hour \| 3,000 req/day | 120 req/min \| 80k req/day |
| Tier 2 (Enterprise) | 80 req/min \| 400 req/hour \| 2,000 req/day | 80 req/min \| 40k req/day |
| Tier 3 (Creator) | 60 req/min \| 300 req/hour \| 1,000 req/day | 60 req/min \| 20k req/day |

If you go above the limits, your response status will be: `429 Too Many Requests` with the following header parameters:

- `RateLimit-Limit`: Indicates which limit has been breached (e.g. "60" for when the 60 requests per minute limit has been breached).
- `RateLimit-Reset`: Indicates how many seconds you must wait before you can send another request.

## Read vs Write Operations

| Write Operations | Read Operations |
| --- | --- |
| [Create a video](https://docs.synthesia.io/reference/create-video#/) | [Retrieve a video](https://docs.synthesia.io/reference/retrieve-a-video#/) |
| [Update a video](https://docs.synthesia.io/reference/update-a-video#/) | [List videos](https://docs.synthesia.io/reference/list-videos#/) |
| [Create a video from a template](https://docs.synthesia.io/reference/create-a-video-from-a-template#/) | [Retrieve a template](https://docs.synthesia.io/reference/retrieve-a-template#/) |
| [Delete a video](https://docs.synthesia.io/reference/delete-a-video#/) | [List templates](https://docs.synthesia.io/reference/list-templates#/) |
| [Create a webhook](https://docs.synthesia.io/reference/create-a-webhook#/) | [Retrieve a webhook](https://docs.synthesia.io/reference/retrieve-a-webhook#/) |
| [Delete a webhook](https://docs.synthesia.io/reference/delete-a-webhook#/) | [List webhooks](https://docs.synthesia.io/reference/list-webhooks#/) |
| [Upload script audio](https://docs.synthesia.io/reference/upload-script-audio#/) |  |
| [Create an asset](https://docs.synthesia.io/reference/create-an-asset#/) |  |

### What’s Next

Get started with Synthesia APIs with the following guides:

- [API Quickstart](https://docs.synthesia.io/reference/synthesia-api-quickstart)
- [Guide: Create a video from template](https://docs.synthesia.io/reference/guide-create-a-video-from-template)
- [Guide: Synthesia <> Zapier integration](https://docs.synthesia.io/reference/guide-synthesia-zapier)