The Orshot Google Drive integration allows you to automatically save generated files directly to your Google Drive account. When enabled, every render (images, PDFs, videos) via the API can be stored in a specified Google Drive folder, making it easy to organize, share, and access your generated content.
If Google Drive is enabled on the Storage page, all your renders will automatically be uploaded to Google Drive — no need to add connections in your API request.
To explicitly control the upload, add the connections parameter to your render request:
{
"templateId": 25,
"modifications": {
"headline": "Hello World"
},
"response": {
"type": "url",
"format": "png"
},
"connections": [
{
"type": "storage",
"provider": "google-drive"
}
]
}Unlike Dropbox, Google Drive does not support specifying a custom folder path in API requests. The folder you select in your workspace settings will be used for all uploads.
Use response.fileName to set a custom name for the uploaded file:
{
"templateId": 25,
"modifications": { "headline": "Hello" },
"response": {
"type": "url",
"format": "png",
"fileName": "marketing-banner-001"
},
"connections": [
{
"type": "storage",
"provider": "google-drive"
}
]
}{
"data": {
"content": "https://store.orshot.com/cloud/w-50/renders/images/abc123.png",
"type": "url",
"format": "png",
"responseTime": "1.2s"
},
"connections": [
{
"type": "storage",
"provider": "google-drive",
"path": "Orshot Renders",
"status": "success"
}
]
}When rendering multi-page templates, each page is uploaded separately:
{
"data": [
{
"page": 1,
"content": "https://storage.orshot.com/cloud/w-50/renders/images/abc123.png"
},
{
"page": 2,
"content": "https://storage.orshot.com/cloud/w-50/renders/images/def456.png"
}
],
"format": "png",
"type": "url",
"responseTime": 3166.01,
"totalPages": 2,
"renderedPages": 2,
"connections": [
{
"type": "storage",
"provider": "google-drive",
"path": [
{ "page": 1, "path": "Orshot Renders" },
{ "page": 2, "path": "Orshot Renders" }
],
"status": "success"
}
]
}Connection issues return warnings but don't block the render:
{
"data": {
"content": "https://store.orshot.com/cloud/w-50/renders/images/abc123.png",
"type": "url",
"format": "png",
"responseTime": "1.2s"
},
"warnings": [
{
"title": "Failed to upload to google-drive: Token expired",
"details": ""
}
],
"connections": [
{
"type": "storage",
"provider": "google-drive",
"path": null,
"status": "error",
"error": "Token expired"
}
]
}{
"data": {
"content": "https://store.orshot.com/cloud/w-50/renders/images/abc123.png",
"type": "url",
"format": "png"
},
"warnings": [
{
"title": "Google Drive connection not found for this workspace",
"details": ""
}
]
}| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Must be "storage" |
provider | string | Yes | Must be "google-drive" |
