Create Document from ClickUp
curl --request POST \
--url https://api.docsautomator.co/createDocument \
--header 'Content-Type: application/json' \
--data '
{
"docId": "<string>",
"taskId": "<string>",
"async": true,
"webhookParams": {},
"skipEsign": true,
"recipients": [
{}
],
"actingUserEmail": "<string>",
"docTemplateLink": "<string>"
}
'import requests
url = "https://api.docsautomator.co/createDocument"
payload = {
"docId": "<string>",
"taskId": "<string>",
"async": True,
"webhookParams": {},
"skipEsign": True,
"recipients": [{}],
"actingUserEmail": "<string>",
"docTemplateLink": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
docId: '<string>',
taskId: '<string>',
async: true,
webhookParams: {},
skipEsign: true,
recipients: [{}],
actingUserEmail: '<string>',
docTemplateLink: '<string>'
})
};
fetch('https://api.docsautomator.co/createDocument', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.docsautomator.co/createDocument",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'docId' => '<string>',
'taskId' => '<string>',
'async' => true,
'webhookParams' => [
],
'skipEsign' => true,
'recipients' => [
[
]
],
'actingUserEmail' => '<string>',
'docTemplateLink' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.docsautomator.co/createDocument"
payload := strings.NewReader("{\n \"docId\": \"<string>\",\n \"taskId\": \"<string>\",\n \"async\": true,\n \"webhookParams\": {},\n \"skipEsign\": true,\n \"recipients\": [\n {}\n ],\n \"actingUserEmail\": \"<string>\",\n \"docTemplateLink\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.docsautomator.co/createDocument")
.header("Content-Type", "application/json")
.body("{\n \"docId\": \"<string>\",\n \"taskId\": \"<string>\",\n \"async\": true,\n \"webhookParams\": {},\n \"skipEsign\": true,\n \"recipients\": [\n {}\n ],\n \"actingUserEmail\": \"<string>\",\n \"docTemplateLink\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.docsautomator.co/createDocument")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"docId\": \"<string>\",\n \"taskId\": \"<string>\",\n \"async\": true,\n \"webhookParams\": {},\n \"skipEsign\": true,\n \"recipients\": [\n {}\n ],\n \"actingUserEmail\": \"<string>\",\n \"docTemplateLink\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyDocuments
Create Document from ClickUp
Trigger document generation for a ClickUp task via the API
POST
/
createDocument
Create Document from ClickUp
curl --request POST \
--url https://api.docsautomator.co/createDocument \
--header 'Content-Type: application/json' \
--data '
{
"docId": "<string>",
"taskId": "<string>",
"async": true,
"webhookParams": {},
"skipEsign": true,
"recipients": [
{}
],
"actingUserEmail": "<string>",
"docTemplateLink": "<string>"
}
'import requests
url = "https://api.docsautomator.co/createDocument"
payload = {
"docId": "<string>",
"taskId": "<string>",
"async": True,
"webhookParams": {},
"skipEsign": True,
"recipients": [{}],
"actingUserEmail": "<string>",
"docTemplateLink": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
docId: '<string>',
taskId: '<string>',
async: true,
webhookParams: {},
skipEsign: true,
recipients: [{}],
actingUserEmail: '<string>',
docTemplateLink: '<string>'
})
};
fetch('https://api.docsautomator.co/createDocument', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.docsautomator.co/createDocument",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'docId' => '<string>',
'taskId' => '<string>',
'async' => true,
'webhookParams' => [
],
'skipEsign' => true,
'recipients' => [
[
]
],
'actingUserEmail' => '<string>',
'docTemplateLink' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.docsautomator.co/createDocument"
payload := strings.NewReader("{\n \"docId\": \"<string>\",\n \"taskId\": \"<string>\",\n \"async\": true,\n \"webhookParams\": {},\n \"skipEsign\": true,\n \"recipients\": [\n {}\n ],\n \"actingUserEmail\": \"<string>\",\n \"docTemplateLink\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.docsautomator.co/createDocument")
.header("Content-Type", "application/json")
.body("{\n \"docId\": \"<string>\",\n \"taskId\": \"<string>\",\n \"async\": true,\n \"webhookParams\": {},\n \"skipEsign\": true,\n \"recipients\": [\n {}\n ],\n \"actingUserEmail\": \"<string>\",\n \"docTemplateLink\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.docsautomator.co/createDocument")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"docId\": \"<string>\",\n \"taskId\": \"<string>\",\n \"async\": true,\n \"webhookParams\": {},\n \"skipEsign\": true,\n \"recipients\": [\n {}\n ],\n \"actingUserEmail\": \"<string>\",\n \"docTemplateLink\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyWhen your automation’s data source is set to ClickUp, you only need to pass the task ID. All field mapping, line items, and output settings are pulled from the DocsAutomator app automatically.
Additional fields like
For setup instructions on connecting ClickUp to DocsAutomator, see the ClickUp integration guide.
Endpoint
POST https://api.docsautomator.co/createDocument
Request Body
string
required
The automation ID. Find it on the automation’s settings page or via
GET /automations.string
required
The ClickUp task ID. DocsAutomator fetches all mapped fields from this task automatically.
boolean
default:"false"
When
true, returns immediately with a jobId (HTTP 202). Poll GET /job/{jobId} for the result.object
Custom parameters passed through to webhook notifications as
webhookParams (plus an identical additionalParams copy kept only for legacy integrations). The triggering taskId is folded in automatically; your own keys are never overwritten.boolean
default:"false"
When
true, skips e-signing for this request even if the automation has e-signing enabled. The document is generated and delivered normally (Drive save, email, webhook), but no signing session is started and no signing invitations are sent. Useful for two-step approval flows: generate a draft for review first, then re-run without skipEsign to send the document for signing. Also accepted as a query parameter (?skipEsign=true) on GET requests.object[]
Who signs or accepts this document. Each entry is
{ "signer": 1, "email": "anna@acme.com", "name": "Anna Weber" }. signer is the signer’s number in the automation: for signing it matches the number in the template tags (1 in {{esign.signature_1}}), for acceptance it is the position in the Recipients list. name is optional; without it the name set in the automation is used.A listed signer’s email and name replace the saved ones for this document only. Signers you leave out keep their saved setup, and nothing is saved on the automation. The automation decides how many signers there are, so recipients never adds a signer. You can leave out signer when the automation has exactly one signer. With two or more signers, every entry needs it.Use it when an AI agent or your own code sends one document to a person it names at send time. The record’s data and the write-back of the signing link and signed PDF work as usual. Triggers from your data source (buttons, formula links, webhooks) do not send recipients, so they keep working exactly as set up.The request fails before anything is generated when a signer number does not exist, the same signer is listed twice, an email is invalid, or the automation has no signing or acceptance step."recipients": [
{ "signer": 1, "email": "anna@acme.com", "name": "Anna Weber" },
{ "signer": 2, "email": "cfo@acme.com" }
]
string
Email address of the team member generating this document. When the automation’s email delivery (or e-signature email settings) has Send from the team member who generates the document enabled, the email is sent from this member’s own connected Gmail or Outlook account instead of the configured sender. The address must match a mailbox connected to the workspace; otherwise DocsAutomator falls back to the automation’s configured sender. Also accepted as a query parameter (
?actingUserEmail=...) on GET requests or as an X-Acting-User-Email request header (the header takes precedence). The in-app Generate button passes this automatically.string
Override the automation’s Google Doc template URL for this request only.
Example
curl -X POST https://api.docsautomator.co/createDocument \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"docId": "YOUR_AUTOMATION_ID",
"taskId": "YOUR_CLICKUP_TASK_ID"
}'
const response = await fetch("https://api.docsautomator.co/createDocument", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
docId: "YOUR_AUTOMATION_ID",
taskId: "YOUR_CLICKUP_TASK_ID",
}),
});
const result = await response.json();
console.log(result.pdfUrl);
import requests
response = requests.post(
"https://api.docsautomator.co/createDocument",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"docId": "YOUR_AUTOMATION_ID",
"taskId": "YOUR_CLICKUP_TASK_ID",
},
)
result = response.json()
print(result["pdfUrl"])
Response
{
"message": "success",
"pdfUrl": "https://files.docsautomator.co/..."
}
googleDocUrl, savePdfGoogleDriveUrl, and e-signature fields are included depending on your automation’s configuration. See the API data source page for the full list.Last modified on September 24, 2026