When your automation’s data source is set to SmartSuite, you only need to pass the record ID. All field mapping, line items, and output settings are pulled from the DocsAutomator app automatically.
The automation ID. Find it on the automation’s settings page or via GET /automations. docId is also accepted, so existing integrations keep working. Send only one of the two: a request with different values in automationId and docId fails with HTTP 400.
string
required
The SmartSuite record ID. DocsAutomator fetches all mapped fields from this record automatically.
boolean
default:"false"
By default the request waits and returns the document (HTTP 200 with pdfUrl). When true, it returns immediately with a jobId (HTTP 202) instead. 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 recId 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.
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.
string
Word templates only. Use a different Word file for this request only: an https link to a .docx file that our servers can download. The data, mapping, signing and output settings still come from the automation in docId. The file can be up to 25 MB. Links to private or internal network addresses are refused.
string
Word templates only. The same as wordTemplateLink, but you send the .docx file itself, encoded as base64, in the JSON body. Use this when you cannot host the file. Up to 25 MB before encoding. Send either wordTemplateLink or wordTemplateBase64, not both.
string
PDF templates only. Use a different PDF as the background for this request only: an https link to a PDF file that our servers can download. The automation’s saved fields are placed on this PDF at their saved positions, for example to fill in a check or a form that another tool created. The data, mapping, signing and output settings still come from the automation in docId. The file can be up to 25 MB. Links to private or internal network addresses are refused, and so are password-protected PDFs.The PDF must have every page that holds a saved field. If a field is on a page the PDF does not have, the request fails and the error names the fields and pages. If a page has a different size from the page in the saved template, each field keeps its distance from the top-left corner of the page and is not scaled. The response then lists the affected pages in warnings.
string
PDF templates only. The same as pdfTemplateLink, but you send the PDF itself, encoded as base64, in the JSON body. Use this when you cannot host the file. Up to 25 MB before encoding. Send either pdfTemplateLink or pdfTemplateBase64, not both.
Additional fields like 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 October 12, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DocsAutomator","colors":{"primary":"#4f46e5","light":"#818cf8","dark":"#3730a3"},"logo":{"light":"https://mintcdn.com/docsautomator/aWJzng63hl4bgVX9/logo/light.svg?fit=max\u0026auto=format\u0026n=aWJzng63hl4bgVX9\u0026q=85\u0026s=a89d4e949fd24be7b244a51939eccb26","dark":"https://mintcdn.com/docsautomator/aWJzng63hl4bgVX9/logo/dark.svg?fit=max\u0026auto=format\u0026n=aWJzng63hl4bgVX9\u0026q=85\u0026s=155c195e2edcade52d5cbcbe58d64b76"},"favicon":"https://mintcdn.com/docsautomator/aWJzng63hl4bgVX9/favicon.svg?fit=max\u0026auto=format\u0026n=aWJzng63hl4bgVX9\u0026q=85\u0026s=9656fbf52a0ead3b218121003b721847","api":{"playground":{"display":"interactive","proxy":true}},"appearance":{},"background":{"decoration":"gradient"},"navbar":{"primary":{"type":"button","label":"Get Started Free","href":"https://app.docsautomator.co"}},"footer":{"socials":{"x":"https://x.com/docsautomator","youtube":"https://youtube.com/@docsautomator"},"links":[{"header":"Product","items":[{"label":"Pricing","href":"https://docsautomator.co/pricing"},{"label":"Template Gallery","href":"https://docsautomator.co/templates"},{"label":"Changelog","href":"/docs/changelog"}]},{"header":"Resources","items":[{"label":"Documentation","href":"/docs"},{"label":"API Reference","href":"/docs/api-reference/introduction"},{"label":"Video Tutorials","href":"https://youtube.com/@docsautomator"}]},{"header":"Company","items":[{"label":"Website","href":"https://docsautomator.co"},{"label":"Book a Call","href":"https://cal.com/docsautomator/20min"},{"label":"Contact","href":"mailto:support@docsautomator.co"}]}]},"search":{"prompt":"Search DocsAutomator docs..."},"seo":{"metatags":{"og:image":"https://docsautomator.co/docs/images/og/docs-default.jpg","og:image:alt":"DocsAutomator documentation","twitter:image":"https://docsautomator.co/docs/images/og/docs-default.jpg","og:site_name":"DocsAutomator Documentation","twitter:card":"summary_large_image","twitter:site":"@docsautomator"},"indexing":"all"},"integrations":{"posthog":{"apiKey":"phc_yPsDdVmPczJK4ypcWm1RiPWfri6c2eSTgCiaQP95X3X"}},"banner":{"content":"E-signing and acceptance are now included in every plan, at no extra cost. [Set it up](/docs/features/docsautomator-esign)","dismissible":true},"contextual":{"options":["copy","chatgpt","claude","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"docsautomator","hasAudioNarration":false,"actualSubdomain":"docsautomator","customDomains":["docsautomator.co"],"gitSource":{"type":"github","owner":"docsautomator","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afb1a396b660d83a8fde406","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Documentation","count":96},{"language":"default","tag":"Features","count":48},{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"Integrations","count":17},{"language":"default","tag":"Resources","count":14},{"language":"default","tag":"Actions After Document Generation","count":10},{"language":"default","tag":"Getting Started","count":9},{"language":"default","tag":"Signing \u0026 Acceptance","count":9},{"language":"default","tag":"Troubleshooting","count":9},{"language":"default","tag":"Documents","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/documents/create-from-smartsuite","slug":"/api-reference/documents/create-from-smartsuite","pageMetadata":{"title":"Create Document from SmartSuite","api":"POST https://api.docsautomator.co/createDocument","description":"Trigger document generation for a SmartSuite record via the API","keywords":["SmartSuite","create document","record ID"],"href":"/api-reference/documents/create-from-smartsuite"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Trigger document generation for a SmartSuite record via the API\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Info,ParamField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`When your automation’s data source is set to `,_jsx(_components.strong,{children:`SmartSuite`}),`, you only need to pass the record ID. All field mapping, line items, and output settings are pulled from the DocsAutomator app automatically.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`For setup instructions on connecting SmartSuite to DocsAutomator, see the `,_jsx(_components.a,{href:`/integrations-api/smartsuite`,children:`SmartSuite integration guide`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST https://api.docsautomator.co/createDocument`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request Body`}),`\n`,_jsx(ParamField,{body:`automationId`,type:`string`,required:true,id:`param-automation-id`,children:_jsxs(_components.p,{children:[`The automation ID. Find it on the automation’s settings page or via `,_jsx(_components.code,{children:`GET /automations`}),`. `,_jsx(_components.code,{children:`docId`}),` is also accepted, so existing integrations keep working. Send only one of the two: a request with different values in `,_jsx(_components.code,{children:`automationId`}),` and `,_jsx(_components.code,{children:`docId`}),` fails with HTTP 400.`]})}),`\n`,_jsx(ParamField,{body:`recId`,type:`string`,required:true,id:`param-rec-id`,children:_jsx(_components.p,{children:`The SmartSuite record ID. DocsAutomator fetches all mapped fields from this record automatically.`})}),`\n`,_jsx(ParamField,{body:`async`,type:`boolean`,default:`false`,id:`param-async`,children:_jsxs(_components.p,{children:[`By default the request waits and returns the document (HTTP 200 with `,_jsx(_components.code,{children:`pdfUrl`}),`). When `,_jsx(_components.code,{children:`true`}),`, it returns immediately with a `,_jsx(_components.code,{children:`jobId`}),` (HTTP 202) instead. Poll `,_jsx(_components.a,{href:`/api-reference/documents/get-job-status`,children:_jsx(_components.code,{children:`GET /job/{jobId}`})}),` for the result.`]})}),`\n`,_jsx(ParamField,{body:`webhookParams`,type:`object`,id:`param-webhook-params`,children:_jsxs(_components.p,{children:[`Custom parameters passed through to webhook notifications as `,_jsx(_components.code,{children:`webhookParams`}),` (plus an identical `,_jsx(_components.code,{children:`additionalParams`}),` copy kept only for legacy integrations). The triggering `,_jsx(_components.code,{children:`recId`}),` is folded in automatically; your own keys are never overwritten.`]})}),`\n`,_jsx(ParamField,{body:`skipEsign`,type:`boolean`,default:`false`,id:`param-skip-esign`,children:_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`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 `,_jsx(_components.code,{children:`skipEsign`}),` to send the document for signing. Also accepted as a query parameter (`,_jsx(_components.code,{children:`?skipEsign=true`}),`) on GET requests.`]})}),`\n`,_jsxs(ParamField,{body:`recipients`,type:`object[]`,id:`param-recipients`,children:[_jsxs(_components.p,{children:[`Who signs or accepts this document. Each entry is `,_jsx(_components.code,{children:`{ \"signer\": 1, \"email\": \"anna@acme.com\", \"name\": \"Anna Weber\" }`}),`. `,_jsx(_components.code,{children:`signer`}),` is the signer’s number in the automation: for signing it matches the number in the template tags (1 in `,_jsx(_components.code,{children:`{{esign.signature_1}}`}),`), for acceptance it is the position in the Recipients list. `,_jsx(_components.code,{children:`name`}),` is optional; without it the name set in the automation is used.`]}),_jsxs(_components.p,{children:[`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 `,_jsx(_components.code,{children:`recipients`}),` never adds a signer. You can leave out `,_jsx(_components.code,{children:`signer`}),` when the automation has exactly one signer. With two or more signers, every entry needs it.`]}),_jsxs(_components.p,{children:[`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 `,_jsx(_components.code,{children:`recipients`}),`, so they keep working exactly as set up.`]}),_jsx(_components.p,{children:`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.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"recipients\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"signer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"anna@acme.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Anna Weber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"signer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cfo@acme.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`]})})})]}),`\n`,_jsx(ParamField,{body:`actingUserEmail`,type:`string`,id:`param-acting-user-email`,children:_jsxs(_components.p,{children:[`Email address of the team member generating this document. When the automation’s email delivery (or e-signature email settings) has `,_jsx(_components.strong,{children:`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 (`,_jsx(_components.code,{children:`?actingUserEmail=...`}),`) on GET requests or as an `,_jsx(_components.code,{children:`X-Acting-User-Email`}),` request header (the header takes precedence). The in-app Generate button passes this automatically.`]})}),`\n`,_jsx(ParamField,{body:`docTemplateLink`,type:`string`,id:`param-doc-template-link`,children:_jsx(_components.p,{children:`Override the automation’s Google Doc template URL for this request only.`})}),`\n`,_jsx(ParamField,{body:`wordTemplateLink`,type:`string`,id:`param-word-template-link`,children:_jsxs(_components.p,{children:[`Word templates only. Use a different Word file for this request only: an https link to a .docx file that our servers can download. The data, mapping, signing and output settings still come from the automation in `,_jsx(_components.code,{children:`docId`}),`. The file can be up to 25 MB. Links to private or internal network addresses are refused.`]})}),`\n`,_jsx(ParamField,{body:`wordTemplateBase64`,type:`string`,id:`param-word-template-base64`,children:_jsxs(_components.p,{children:[`Word templates only. The same as `,_jsx(_components.code,{children:`wordTemplateLink`}),`, but you send the .docx file itself, encoded as base64, in the JSON body. Use this when you cannot host the file. Up to 25 MB before encoding. Send either `,_jsx(_components.code,{children:`wordTemplateLink`}),` or `,_jsx(_components.code,{children:`wordTemplateBase64`}),`, not both.`]})}),`\n`,_jsxs(ParamField,{body:`pdfTemplateLink`,type:`string`,id:`param-pdf-template-link`,children:[_jsxs(_components.p,{children:[`PDF templates only. Use a different PDF as the background for this request only: an https link to a PDF file that our servers can download. The automation’s saved fields are placed on this PDF at their saved positions, for example to fill in a check or a form that another tool created. The data, mapping, signing and output settings still come from the automation in `,_jsx(_components.code,{children:`docId`}),`. The file can be up to 25 MB. Links to private or internal network addresses are refused, and so are password-protected PDFs.`]}),_jsxs(_components.p,{children:[`The PDF must have every page that holds a saved field. If a field is on a page the PDF does not have, the request fails and the error names the fields and pages. If a page has a different size from the page in the saved template, each field keeps its distance from the top-left corner of the page and is not scaled. The response then lists the affected pages in `,_jsx(_components.code,{children:`warnings`}),`.`]})]}),`\n`,_jsx(ParamField,{body:`pdfTemplateBase64`,type:`string`,id:`param-pdf-template-base64`,children:_jsxs(_components.p,{children:[`PDF templates only. The same as `,_jsx(_components.code,{children:`pdfTemplateLink`}),`, but you send the PDF itself, encoded as base64, in the JSON body. Use this when you cannot host the file. Up to 25 MB before encoding. Send either `,_jsx(_components.code,{children:`pdfTemplateLink`}),` or `,_jsx(_components.code,{children:`pdfTemplateBase64`}),`, not both.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.docsautomator.co/createDocument`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"automationId\": \"YOUR_AUTOMATION_ID\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"recId\": \"YOUR_SMARTSUITE_RECORD_ID\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`14`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.docsautomator.co/createDocument\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` automationId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"YOUR_AUTOMATION_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` recId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"YOUR_SMARTSUITE_RECORD_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` result`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`pdfUrl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`16`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.docsautomator.co/createDocument\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"automationId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_AUTOMATION_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"recId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_SMARTSUITE_RECORD_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(result[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pdfUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`])`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pdfUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://files.docsautomator.co/...\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Additional fields like `,_jsx(_components.code,{children:`googleDocUrl`}),`, `,_jsx(_components.code,{children:`savePdfGoogleDriveUrl`}),`, and e-signature fields are included depending on your automation’s configuration. See the `,_jsx(_components.a,{href:`/api-reference/documents/create-from-api#response`,children:`API data source page`}),` for the full list.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Document from SmartSuite","api":"POST https://api.docsautomator.co/createDocument","description":"Trigger document generation for a SmartSuite record via the API","keywords":["SmartSuite","create document","record ID"],"href":"/api-reference/documents/create-from-smartsuite"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Request Body","slug":"request-body","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create Document from SmartSuite","path":"/createDocument","servers":[{"url":"https://api.docsautomator.co"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"automationId":[{"type":"string","description":"The automation ID. Find it on the automation’s settings page or via `GET /automations` . `docId` is also accepted, so existing integrations keep working. Send only one of the two: a request with different values in `automationId` and `docId` fails with HTTP 400.","required":true}],"recId":[{"type":"string","description":"The SmartSuite record ID. DocsAutomator fetches all mapped fields from this record automatically.","required":true}],"async":[{"type":"boolean","description":"By default the request waits and returns the document (HTTP 200 with `pdfUrl` ). When `true` , it returns immediately with a `jobId` (HTTP 202) instead. Poll `GET /job/{jobId}` for the result."}],"webhookParams":[{"type":"object","properties":{},"description":"Custom parameters passed through to webhook notifications as `webhookParams` (plus an identical `additionalParams` copy kept only for legacy integrations). The triggering `recId` is folded in automatically; your own keys are never overwritten."}],"skipEsign":[{"type":"boolean","description":"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."}],"recipients":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"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."}],"actingUserEmail":[{"type":"string","description":"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."}],"docTemplateLink":[{"type":"string","description":"Override the automation’s Google Doc template URL for this request only."}],"wordTemplateLink":[{"type":"string","description":"Word templates only. Use a different Word file for this request only: an https link to a .docx file that our servers can download. The data, mapping, signing and output settings still come from the automation in `docId` . The file can be up to 25 MB. Links to private or internal network addresses are refused."}],"wordTemplateBase64":[{"type":"string","description":"Word templates only. The same as `wordTemplateLink` , but you send the .docx file itself, encoded as base64, in the JSON body. Use this when you cannot host the file. Up to 25 MB before encoding. Send either `wordTemplateLink` or `wordTemplateBase64` , not both."}],"pdfTemplateLink":[{"type":"string","description":"PDF templates only. Use a different PDF as the background for this request only: an https link to a PDF file that our servers can download. The automation’s saved fields are placed on this PDF at their saved positions, for example to fill in a check or a form that another tool created. The data, mapping, signing and output settings still come from the automation in `docId` . The file can be up to 25 MB. Links to private or internal network addresses are refused, and so are password-protected PDFs. The PDF must have every page that holds a saved field. If a field is on a page the PDF does not have, the request fails and the error names the fields and pages. If a page has a different size from the page in the saved template, each field keeps its distance from the top-left corner of the page and is not scaled. The response then lists the affected pages in `warnings` ."}],"pdfTemplateBase64":[{"type":"string","description":"PDF templates only. The same as `pdfTemplateLink` , but you send the PDF itself, encoded as base64, in the JSON body. Use this when you cannot host the file. Up to 25 MB before encoding. Send either `pdfTemplateLink` or `pdfTemplateBase64` , not both."}]}}],"examples":{"example":{"value":{"automationId":"\u003cstring>","recId":"\u003cstring>","async":true,"webhookParams":{},"skipEsign":true,"recipients":[{}],"actingUserEmail":"\u003cstring>","docTemplateLink":"\u003cstring>","wordTemplateLink":"\u003cstring>","wordTemplateBase64":"\u003cstring>","pdfTemplateLink":"\u003cstring>","pdfTemplateBase64":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"docsautomator","siteName":"DocsAutomator","title":"Create Document from SmartSuite - DocsAutomator","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-12T09:36:26.527Z","gitLastModified":"2026-10-12T09:35:35.000Z","originalFileLocation":"api-reference/documents/create-from-smartsuite.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Trigger document generation for a SmartSuite record via the API\">\u003cmeta data-mint-head name=\"application-name\" content=\"DocsAutomator\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Document from SmartSuite - DocsAutomator\">\u003cmeta data-mint-head property=\"og:description\" content=\"Trigger document generation for a SmartSuite record via the API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DocsAutomator Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docsautomator.co/docs/images/og/docs-default.jpg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Document from SmartSuite - DocsAutomator\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Trigger document generation for a SmartSuite record via the API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docsautomator.co/docs/images/og/docs-default.jpg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/docsautomator/rNkJLQINO18QuKfc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DocsAutomator\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4f46e5\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"DocsAutomator documentation\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/documents/create-from-smartsuite.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docsautomator.co/#organization\",\"name\":\"DocsAutomator\",\"url\":\"https://docsautomator.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/docsautomator/aWJzng63hl4bgVX9/logo/light.svg?fit=max\u0026auto=format\u0026n=aWJzng63hl4bgVX9\u0026q=85\u0026s=a89d4e949fd24be7b244a51939eccb26\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docsautomator.co/docs#website\",\"name\":\"DocsAutomator\",\"url\":\"https://docsautomator.co/docs\",\"publisher\":{\"@id\":\"https://docsautomator.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite#webpage\",\"url\":\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite\",\"name\":\"Create Document from SmartSuite\",\"description\":\"Trigger document generation for a SmartSuite record via the API\",\"dateModified\":\"2026-10-12T09:35:35.000Z\",\"isPartOf\":{\"@id\":\"https://docsautomator.co/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Documents\",\"item\":\"https://docsautomator.co/docs/api-reference/documents/create-from-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Document from SmartSuite\",\"item\":\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite#apireference\",\"headline\":\"Create Document from SmartSuite\",\"name\":\"Create Document from SmartSuite\",\"description\":\"Trigger document generation for a SmartSuite record via the API\",\"url\":\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite\",\"mainEntityOfPage\":{\"@id\":\"https://docsautomator.co/docs/api-reference/documents/create-from-smartsuite#webpage\"},\"image\":\"https://docsautomator.co/docs/images/og/docs-default.jpg\",\"dateModified\":\"2026-10-12T09:35:35.000Z\",\"keywords\":\"SmartSuite, create document, record ID\",\"publisher\":{\"@id\":\"https://docsautomator.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docsautomator.co/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DocsAutomator\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"DocsAutomator\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/documents/create-from-smartsuite.md","siteName":"DocsAutomator","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Documents","pages":[{"title":"Create Document via API","api":"POST https://api.docsautomator.co/createDocument","href":"/api-reference/documents/create-from-api"},{"title":"Create Document from Airtable","api":"POST https://api.docsautomator.co/createDocument","href":"/api-reference/documents/create-from-airtable"},{"title":"Create Document from Notion","api":"POST https://api.docsautomator.co/createDocument","href":"/api-reference/documents/create-from-notion"},{"title":"Create Document from Google Sheets","api":"POST https://api.docsautomator.co/createDocument","description":"Trigger document generation for a Google Sheets row via the API","href":"/api-reference/documents/create-from-google-sheets"},{"title":"Create Document from SmartSuite","api":"POST https://api.docsautomator.co/createDocument","href":"/api-reference/documents/create-from-smartsuite"},{"title":"Create Document from ClickUp","api":"POST https://api.docsautomator.co/createDocument","description":"Trigger document generation for a ClickUp task via the API","href":"/api-reference/documents/create-from-clickup"},{"title":"Get job status","deprecated":null,"version":null,"openapi":"/openapi.json get /job/{jobId}","href":"/api-reference/documents/get-job-status"},{"title":"Get queue statistics","deprecated":null,"version":null,"openapi":"/openapi.json get /queue/stats","href":"/api-reference/documents/get-queue-statistics"}]},{"group":"Automations","pages":[{"title":"List automations","deprecated":null,"version":null,"openapi":"/openapi.json get /automations","href":"/api-reference/automations/list-automations"},{"title":"Get automation","deprecated":null,"version":null,"openapi":"/openapi.json get /automation","href":"/api-reference/automations/get-automation"},{"title":"Create automation","deprecated":null,"version":null,"openapi":"/openapi.json post /createAutomation","href":"/api-reference/automations/create-automation"},{"title":"Update automation","deprecated":null,"version":null,"openapi":"/openapi.json put /updateAutomation","href":"/api-reference/automations/update-automation"},{"title":"Delete automation","deprecated":null,"version":null,"openapi":"/openapi.json delete /deleteAutomation","href":"/api-reference/automations/delete-automation"},{"title":"Duplicate automation","deprecated":null,"version":null,"openapi":"/openapi.json post /duplicateAutomation","href":"/api-reference/automations/duplicate-automation"}]},{"group":"Templates","pages":[{"title":"List template placeholders","deprecated":null,"version":null,"openapi":"/openapi.json get /listPlaceholdersV2","href":"/api-reference/templates/list-template-placeholders"},{"title":"Duplicate template","deprecated":null,"version":null,"openapi":"/openapi.json post /duplicateGoogleDocTemplate","href":"/api-reference/templates/duplicate-template"}]},{"group":"E-Signatures","pages":[{"title":"List signing sessions","deprecated":null,"version":null,"openapi":"/openapi.json get /esign/sessions","href":"/api-reference/e-signatures/list-signing-sessions"},{"title":"Get session details","deprecated":null,"version":null,"openapi":"/openapi.json get /esign/sessions/{sessionId}","href":"/api-reference/e-signatures/get-session-details"},{"title":"Get signing links","deprecated":null,"version":null,"openapi":"/openapi.json get /esign/sessions/{sessionId}/links","href":"/api-reference/e-signatures/get-signing-links"},{"title":"Get audit trail","deprecated":null,"version":null,"openapi":"/openapi.json get /esign/sessions/{sessionId}/audit","href":"/api-reference/e-signatures/get-audit-trail"},{"title":"Cancel signing session","deprecated":null,"version":null,"openapi":"/openapi.json post /esign/sessions/{sessionId}/cancel","href":"/api-reference/e-signatures/cancel-signing-session"},{"title":"Resend signing invitation","deprecated":null,"version":null,"openapi":"/openapi.json post /esign/sessions/{sessionId}/resend/{signerIndex}","href":"/api-reference/e-signatures/resend-signing-invitation"}]},{"group":"Email","pages":[{"title":"Send test email","deprecated":null,"version":null,"openapi":"/openapi.json post /sendTestEmail","href":"/api-reference/email/send-test-email"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Create Document from SmartSuite - DocsAutomator","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["BannerMarkdown-L4KFxIos.js","dist-B0ZV6X5T.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-B6IZIRsp.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CQGbdtm4.js","utils-D88A1f-Z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChqWdz1A.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-yBrxdh_6.js","snippetPresets-BgqDrFJC.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Duxc2rZw.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C7jidOil.js","shallow-xkjpHm-U.js","getApiPlaygroundDisplay-fE3rVpvL.js","CodeSnippet-LgxljKed.js","CodeSnippets-D-pXWDHq.js","Page-C2-BijcO.js","getPastedJson-CLRcu-uo.js","icon-Cxirpjgo.js","MethodPill-D49eqY5e.js","DuplicateIcon-CivCz5Rp.js","createIcon-D71qL3f5.js","DynamicMarkdown-BcGRTrw6.js","SectionHeading-DzaqmmSD.js","axios-vUo_bRtp.js"]}