Sharing
Public links to templates, forms and automations, and copies made from them.
Sharing tools
| Tool | What it does |
|---|---|
| listShareLinks | Every template, form and automation that is public, newest link first, with its link and how often it was opened and copied. |
| getShareLink | Whether one item is public, and its link when it is. |
| setShareLink | Make an item public at a link anyone can open without an account, or change whether people may copy it. |
| deleteShareLink | Make an item private again. The link stops working at once, and copies already made stay. |
| getSharedItem | Read what a public link shows, from any workspace, before deciding to copy it. Takes the whole link or its token. |
| copySharedItem | Copy the item at a public link into this workspace as a new draft. |
A copy carries the design only: never the sign-ups, sends, runs or contacts the original collected. The audiences, sender addresses, forms and webhook endpoints an automation points at are left empty, the templates it sends are copied with it, and the images a template shows are copied into the workspace.
Each tool takes the scope of the kind it acts on, templates:*, forms:* or automations:*, and copying an automation that sends templates also takes templates:write. In the app’s chat, the three that change something ask first unless you asked for them.
Reference
listShareLinks
The templates, forms and automations of this workspace that are public, newest link first, each with its public link, whether people may copy it, and how often it was opened and copied. kind keeps one of the three. Kinds you cannot read are left out.
Inputs
kindstring- One of
"template""form""automation" cursorstringnextCursor from the previous page.
1 to 128 characters
Also available in
- API
GET /share-links- TypeScript
shareLinks.list()shareLinks.listAll()shareLinks.iterate()- Python
share_links.list()share_links.list_all()share_links.iterate()- Ruby
share_links.listshare_links.list_allshare_links.iterate- PHP
shareLinks->listshareLinks->listAllshareLinks->iterate- Go
ShareLinks.ListShareLinks.ListAllShareLinks.Iterate- Java
shareLinks().listshareLinks().listAllshareLinks().iterate- C#
ShareLinks.ListAsyncShareLinks.ListAllAsyncShareLinks.IterateAsync
getShareLink
Whether one template, form or automation is public, and if it is, its public link, whether people may copy it and how often it was opened and copied.
Inputs
kindstringRequired- One of
"template""form""automation" itemIdstringRequired- 1 to 128 characters
Also available in
setShareLink
Make a template, form or automation public at a link anyone can open without an account, as Share does in the app, or change whether people may copy it. copyable is true for a new link and left as it was when omitted. The page shows the published version, or the draft when nothing was published. A copy carries the design only: never the submissions, sends, runs or contacts the original collected, and never the audiences, addresses, forms or webhook endpoints it points at, which stay with the owner and are left empty for you to fill in. The templates an automation sends are copied with it, and the images a template shows are copied into your workspace.
Inputs
kindstringRequired- One of
"template""form""automation" itemIdstringRequired- 1 to 128 characters
copyableboolean
Also available in
deleteShareLink
Make a template, form or automation private again: its public link stops working at once for everyone, and copies people already made stay theirs. Sharing it again gives a new link.
Inputs
kindstringRequired- One of
"template""form""automation" itemIdstringRequired- 1 to 128 characters
Also available in
getSharedItem
Read what a public link shows, from any workspace: the shared template, form or automation, who shares it and whether it may be copied, with its subject and props, its fields, or its trigger and steps. Use it before copySharedItem to tell the user what they would get.
Inputs
linkstringRequiredThe public link, or just the token at the end of it.
1 to 512 characters
copySharedItem
Copy the template, form or automation at a public link into this workspace as a new draft, as Copy to my workspace does on its page, and say where it landed. A copy carries the design only: never the submissions, sends, runs or contacts the original collected, and never the audiences, addresses, forms or webhook endpoints it points at, which stay with the owner and are left empty for you to fill in. The templates an automation sends are copied with it, and the images a template shows are copied into your workspace.
Inputs
linkstringRequiredThe public link, or just the token at the end of it.
1 to 512 characters
Also available in
- API
POST /shared/{token}/copy- TypeScript
shared.copy()- Python
shared.copy()- Ruby
shared.copy- PHP
shared->copy- Go
Shared.Copy- Java
shared().copy- C#
Shared.CopyAsync
Google Workspace