One way to add placeholders to a contract is when you create a new contract.
See this page to learn more.If a contract already exists, use the request below.
Body parameters
object
required
Show child attribute
string
required
Action type.
string
required
Key of the client.
string
required
Key of the contract.
object
required
Structure, add the fields that need to be updated and ignore the rest.
Show child attribute
string
required
Name of the placeholder
string
Value of the placeholder.
number
Who fills in this placeholder when the contract is shared (“Who fills in this field” in the editor):
1 — nobody (default), 2 — the contract owner, 3 — any recipient, 4 — a specific recipient set in externalRecipientKey.
See the use case.
string
recipientKey of the recipient who fills in this placeholder. Required when fillingType is 4.
Get it from the list of recipients. Leave it out (or null) for any other fillingType.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Sendforsign documentation","colors":{"primary":"#9563FF","light":"#AE87FF","dark":"#0D001D"},"favicon":"https://mintcdn.com/sendforsign/bDeZDTsZ_41-V2Bk/favicon.png?fit=max\u0026auto=format\u0026n=bDeZDTsZ_41-V2Bk\u0026q=85\u0026s=6f1820390f91591a0b39203b557d002d","logo":{"light":"https://mintcdn.com/sendforsign/bDeZDTsZ_41-V2Bk/logo/light.svg?fit=max\u0026auto=format\u0026n=bDeZDTsZ_41-V2Bk\u0026q=85\u0026s=8164bbc8e8ee371f6818856b17826f6c","dark":"https://mintcdn.com/sendforsign/bDeZDTsZ_41-V2Bk/logo/dark.svg?fit=max\u0026auto=format\u0026n=bDeZDTsZ_41-V2Bk\u0026q=85\u0026s=9ab81cd69fe1e1af8ee9afed9312a54e"},"api":{"mdx":{"server":"https://api.sendforsign.com/api","auth":{"method":"key","name":"X-Sendforsign-Key"}}},"appearance":{"default":"light","strict":false},"background":{"decoration":null,"color":{"light":null,"dark":"#090014"}},"navbar":{"links":[{"label":"Feedback","href":"https://airtable.com/app8jiZb9qU4pNdYb/pag9rl2atRJUkFjpS/form"},{"label":"Blog","href":"https://sendforsign.com/blog"}],"primary":{"type":"button","label":"sendforsign.com","href":"https://sendforsign.com"}},"seo":{"metatags":{"canonical":"https://sendforsign.com/docs"},"indexing":"navigable"},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/sendforsign/about/","youtube":"https://www.youtube.com/@Sendforsign/videos"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sendforsign","hasAudioNarration":false,"actualSubdomain":"sendforsign","customDomains":["sendforsign.com"],"gitSource":{"type":"github","owner":"kaleido-so","repo":"sendforsign-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afd904136e6bb5efca0fef9","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Reference","count":54},{"language":"default","tag":"AI agents","count":12},{"language":"default","tag":"Contract","count":10},{"language":"default","tag":"About","count":8},{"language":"default","tag":"Template","count":8},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Placeholder","count":7},{"language":"default","tag":"Use cases","count":7},{"language":"default","tag":"Webhook","count":6},{"language":"default","tag":"React Components","count":6}]},"assistantConfig":{},"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/placeholder/create","slug":"/api-reference/placeholder/create","pageMetadata":{"title":"Create placeholder","api":"POST https://api.sendforsign.com/api/placeholder","description":"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.","href":"/api-reference/placeholder/create"},"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: \"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.\"\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`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`One way to add placeholders to a contract is when you create a new contract.\n`,_jsx(_components.a,{href:`/api-reference/contract/create-fill`,children:`See this page`}),` to learn more.`]}),`\n`,_jsx(_components.p,{children:`If a contract already exists, use the request below.`}),`\n`,_jsx(Heading,{level:`3`,id:`body-parameters`,children:`Body parameters`}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data`,children:_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action`,children:_jsx(_components.p,{children:`Action type.`})}),_jsx(ParamField,{body:`clientKey`,type:`string`,required:true,id:`param-client-key`,children:_jsx(_components.p,{children:`Key of the client.`})}),_jsx(ParamField,{body:`contractKey`,type:`string`,required:true,id:`param-contract-key`,children:_jsx(_components.p,{children:`Key of the contract.`})}),_jsxs(ParamField,{body:`placeholder`,type:`object`,required:true,id:`param-placeholder`,children:[_jsx(_components.p,{children:`Structure, add the fields that need to be updated and ignore the rest.`}),_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Name of the placeholder`})}),_jsx(ParamField,{body:`value`,type:`string`,id:`param-value`,children:_jsx(_components.p,{children:`Value of the placeholder.`})}),_jsx(ParamField,{body:`fillingType`,type:`number`,id:`param-filling-type`,children:_jsxs(_components.p,{children:[`Who fills in this placeholder when the contract is shared (“Who fills in this field” in the editor):\n`,_jsx(_components.code,{children:`1`}),` — nobody (default), `,_jsx(_components.code,{children:`2`}),` — the contract owner, `,_jsx(_components.code,{children:`3`}),` — any recipient, `,_jsx(_components.code,{children:`4`}),` — a specific recipient set in `,_jsx(_components.code,{children:`externalRecipientKey`}),`.\n`,_jsx(_components.a,{href:`/usecase/placeholder-filler`,children:`See the use case.`})]})}),_jsx(ParamField,{body:`externalRecipientKey`,type:`string`,id:`param-external-recipient-key`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`recipientKey`}),` of the recipient who fills in this placeholder. Required when `,_jsx(_components.code,{children:`fillingType`}),` is `,_jsx(_components.code,{children:`4`}),`.\nGet it from the `,_jsx(_components.a,{href:`/api-reference/recipient/list`,children:`list of recipients`}),`. Leave it out (or `,_jsx(_components.code,{children:`null`}),`) for any other `,_jsx(_components.code,{children:`fillingType`}),`.`]})})]})]})]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`placeholder`,type:`string`,id:`param-placeholder-1`,children:[_jsx(_components.p,{children:`Placeholder structure.`}),_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ResponseField,{name:`createTime`,type:`string`,id:`param-create-time`,children:_jsx(_components.p,{children:`Create time.`})}),_jsx(ResponseField,{name:`changeTime`,type:`string`,id:`param-change-time`,children:_jsx(_components.p,{children:`Change time.`})})]})]}),`\n`,_jsx(ResponseField,{name:`code`,type:`string`,id:`param-code`,children:_jsx(_components.p,{children:`The code of the answer.`})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:_jsx(_components.p,{children:`The message of the answer.`})})]})}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 placeholder","api":"POST https://api.sendforsign.com/api/placeholder","description":"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.","href":"/api-reference/placeholder/create"}}},"mdxSourceWithNoJs":{"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`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`One way to add placeholders to a contract is when you create a new contract.\n`,_jsx(_components.a,{href:`/api-reference/contract/create-fill`,children:`See this page`}),` to learn more.`]}),`\n`,_jsx(_components.p,{children:`If a contract already exists, use the request below.`}),`\n`,_jsx(Heading,{level:`3`,id:`body-parameters`,children:`Body parameters`}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data`,children:_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action`,children:_jsx(_components.p,{children:`Action type.`})}),_jsx(ParamField,{body:`clientKey`,type:`string`,required:true,id:`param-client-key`,children:_jsx(_components.p,{children:`Key of the client.`})}),_jsx(ParamField,{body:`contractKey`,type:`string`,required:true,id:`param-contract-key`,children:_jsx(_components.p,{children:`Key of the contract.`})}),_jsxs(ParamField,{body:`placeholder`,type:`object`,required:true,id:`param-placeholder`,children:[_jsx(_components.p,{children:`Structure, add the fields that need to be updated and ignore the rest.`}),_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Name of the placeholder`})}),_jsx(ParamField,{body:`value`,type:`string`,id:`param-value`,children:_jsx(_components.p,{children:`Value of the placeholder.`})}),_jsx(ParamField,{body:`fillingType`,type:`number`,id:`param-filling-type`,children:_jsxs(_components.p,{children:[`Who fills in this placeholder when the contract is shared (“Who fills in this field” in the editor):\n`,_jsx(_components.code,{children:`1`}),` — nobody (default), `,_jsx(_components.code,{children:`2`}),` — the contract owner, `,_jsx(_components.code,{children:`3`}),` — any recipient, `,_jsx(_components.code,{children:`4`}),` — a specific recipient set in `,_jsx(_components.code,{children:`externalRecipientKey`}),`.\n`,_jsx(_components.a,{href:`/usecase/placeholder-filler`,children:`See the use case.`})]})}),_jsx(ParamField,{body:`externalRecipientKey`,type:`string`,id:`param-external-recipient-key`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`recipientKey`}),` of the recipient who fills in this placeholder. Required when `,_jsx(_components.code,{children:`fillingType`}),` is `,_jsx(_components.code,{children:`4`}),`.\nGet it from the `,_jsx(_components.a,{href:`/api-reference/recipient/list`,children:`list of recipients`}),`. Leave it out (or `,_jsx(_components.code,{children:`null`}),`) for any other `,_jsx(_components.code,{children:`fillingType`}),`.`]})})]})]})]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`placeholder`,type:`string`,id:`param-placeholder-1`,children:[_jsx(_components.p,{children:`Placeholder structure.`}),_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ResponseField,{name:`createTime`,type:`string`,id:`param-create-time`,children:_jsx(_components.p,{children:`Create time.`})}),_jsx(ResponseField,{name:`changeTime`,type:`string`,id:`param-change-time`,children:_jsx(_components.p,{children:`Change time.`})})]})]}),`\n`,_jsx(ResponseField,{name:`code`,type:`string`,id:`param-code`,children:_jsx(_components.p,{children:`The code of the answer.`})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:_jsx(_components.p,{children:`The message of the answer.`})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`16`,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:`16`,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.sendforsign.com/api/placeholder'`}),_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:` 'X-Sendforsign-Key: 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:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"create\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"clientKey\": \"YOUR_CLIENT_KEY\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contractKey\": \"CONTRACT_KEY\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"placeholder\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Placeholder name\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"value\": \"Placeholder value\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fillingType\": 4,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"externalRecipientKey\": \"RECIPIENT_KEY\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`}'`})}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Response`,numberOfLines:`14`,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:`14`,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:` \"placeholder\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3\"`}),_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:` \"createTime\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2024-11-22T11:11:24.000Z\"`}),_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:` \"changeTime\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2024-11-22T11:11:24.000Z\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1\"`}),_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:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hello\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1\"`}),_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:` \"placeholderKey\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PLACEHOLDER_KEY\"`}),_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:` \"position\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3\"`})]}),`\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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`201`}),_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:`\"Placeholder created\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}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 placeholder","api":"POST https://api.sendforsign.com/api/placeholder","description":"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.","href":"/api-reference/placeholder/create"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Body parameters","slug":"body-parameters","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"16\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.sendforsign.com/api/placeholder'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'X-Sendforsign-Key: YOUR_API_KEY'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type: application/json'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"data\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"action\": \"create\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"clientKey\": \"YOUR_CLIENT_KEY\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"contractKey\": \"CONTRACT_KEY\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"placeholder\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"name\": \"Placeholder name\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"value\": \"Placeholder value\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"fillingType\": 4,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"externalRecipientKey\": \"RECIPIENT_KEY\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">}'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"Response","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"14\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"placeholder\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"3\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"createTime\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2024-11-22T11:11:24.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"changeTime\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2024-11-22T11:11:24.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"value\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"hello\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"placeholderKey\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PLACEHOLDER_KEY\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"position\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"3\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">201\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Placeholder created\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Create placeholder","path":"/api/placeholder","servers":[{"url":"https://api.sendforsign.com"}],"method":"post","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"X-Sendforsign-Key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"data":[{"type":"object","properties":{"action":[{"type":"string","description":"Action type.","required":true}],"clientKey":[{"type":"string","description":"Key of the client.","required":true}],"contractKey":[{"type":"string","description":"Key of the contract.","required":true}],"placeholder":[{"type":"object","properties":{"name":[{"type":"string","description":"Name of the placeholder","required":true}],"value":[{"type":"string","description":"Value of the placeholder."}],"fillingType":[{"type":"number","description":"Who fills in this placeholder when the contract is shared (“Who fills in this field” in the editor): `1` — nobody (default), `2` — the contract owner, `3` — any recipient, `4` — a specific recipient set in `externalRecipientKey` . See the use case."}],"externalRecipientKey":[{"type":"string","description":"`recipientKey` of the recipient who fills in this placeholder. Required when `fillingType` is `4` . Get it from the list of recipients . Leave it out (or `null` ) for any other `fillingType` ."}]},"description":"Structure, add the fields that need to be updated and ignore the rest.","required":true}]},"required":true}]}}],"examples":{"example":{"value":{"data":{"action":"\u003cstring>","clientKey":"\u003cstring>","contractKey":"\u003cstring>","placeholder":{"name":"\u003cstring>","value":"\u003cstring>","fillingType":123,"externalRecipientKey":"\u003cstring>"}}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"placeholder":[{"type":"string","description":"Placeholder structure."}],"code":[{"type":"string","description":"The code of the answer."}],"message":[{"type":"string","description":"The message of the answer."}]}}],"examples":{"example":{"value":{"placeholder":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"sendforsign","siteName":"Sendforsign documentation","title":"Create placeholder - Sendforsign documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T13:03:31.629Z","originalFileLocation":"api-reference/placeholder/create.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=\"light\"}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=\"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sendforsign documentation\">\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/sendforsign/ZRijGtN2932N6-gY/_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/sendforsign/ZRijGtN2932N6-gY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/sendforsign/ZRijGtN2932N6-gY/_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/sendforsign/ZRijGtN2932N6-gY/_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/sendforsign/ZRijGtN2932N6-gY/_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/sendforsign/ZRijGtN2932N6-gY/_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/sendforsign/ZRijGtN2932N6-gY/_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/sendforsign/ZRijGtN2932N6-gY/_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/sendforsign/ZRijGtN2932N6-gY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create placeholder - Sendforsign documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sendforsign documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://sendforsign.com/docs/api-reference/placeholder/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sendforsign.mintlify.site/docs/_mintlify/api/og/v2?division=Placeholder\u0026amp;title=Create+placeholder\u0026amp;description=Add+a+placeholder+to+a+contract+or+template+with+the+Sendforsign+API%2C+and+choose+who+fills+it+in.\u0026amp;theme=dc911e1386ddeabcf1258e9f\u0026amp;signature=7ce77bad75226fba5fabbab7fc8e9995ab4f302e2fc525ee5b8570b3cb6e0153\">\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 placeholder - Sendforsign documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sendforsign.mintlify.site/docs/_mintlify/api/og/v2?division=Placeholder\u0026amp;title=Create+placeholder\u0026amp;description=Add+a+placeholder+to+a+contract+or+template+with+the+Sendforsign+API%2C+and+choose+who+fills+it+in.\u0026amp;theme=dc911e1386ddeabcf1258e9f\u0026amp;signature=7ce77bad75226fba5fabbab7fc8e9995ab4f302e2fc525ee5b8570b3cb6e0153\">\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/sendforsign/ZRijGtN2932N6-gY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sendforsign documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9563FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://sendforsign.com/docs/api-reference/placeholder/create\">\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/placeholder/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://sendforsign.com/#organization\",\"name\":\"Sendforsign documentation\",\"url\":\"https://sendforsign.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sendforsign/bDeZDTsZ_41-V2Bk/logo/light.svg?fit=max\u0026auto=format\u0026n=bDeZDTsZ_41-V2Bk\u0026q=85\u0026s=8164bbc8e8ee371f6818856b17826f6c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://sendforsign.com/docs#website\",\"name\":\"Sendforsign documentation\",\"url\":\"https://sendforsign.com/docs\",\"publisher\":{\"@id\":\"https://sendforsign.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/create#webpage\",\"url\":\"https://sendforsign.com/docs/api-reference/placeholder/create\",\"name\":\"Create placeholder\",\"description\":\"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.\",\"dateModified\":\"2026-11-16T13:03:31.629Z\",\"isPartOf\":{\"@id\":\"https://sendforsign.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sendforsign documentation\",\"item\":\"https://sendforsign.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create placeholder\",\"item\":\"https://sendforsign.com/docs/api-reference/placeholder/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/create#apireference\",\"headline\":\"Create placeholder\",\"name\":\"Create placeholder\",\"description\":\"Add a placeholder to a contract or template with the Sendforsign API, and choose who fills it in.\",\"url\":\"https://sendforsign.com/docs/api-reference/placeholder/create\",\"mainEntityOfPage\":{\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/create#webpage\"},\"dateModified\":\"2026-11-16T13:03:31.629Z\",\"publisher\":{\"@id\":\"https://sendforsign.com/#organization\"},\"isPartOf\":{\"@id\":\"https://sendforsign.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sendforsign documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sendforsign documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/placeholder/create.md","siteName":"Sendforsign documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"AI agents","pages":[{"title":"AI agents","href":"/ai-agents/overview"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Sendforsign API introduction","sidebarTitle":"Introduction","href":"/api-reference/introapi"},{"title":"Account structure","href":"/api-reference/structure"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Implement server side","href":"/api-reference/implementation_server"},{"title":"Implement client side","href":"/api-reference/implementation_client"}]},{"group":"Client","pages":[{"title":"Create client","api":"POST https://api.sendforsign.com/api/client","href":"/api-reference/client/create"},{"title":"Update client","api":"POST https://api.sendforsign.com/api/client","href":"/api-reference/client/update"},{"title":"Read client","api":"POST https://api.sendforsign.com/api/client","href":"/api-reference/client/read"},{"title":"List of clients","api":"POST https://api.sendforsign.com/api/client","href":"/api-reference/client/list"}]},{"group":"User","pages":[{"title":"Create user","api":"POST https://api.sendforsign.com/api/user","href":"/api-reference/user/create"},{"title":"Update user","api":"POST https://api.sendforsign.com/api/user","href":"/api-reference/user/update"},{"title":"Read user","api":"POST https://api.sendforsign.com/api/user","href":"/api-reference/user/read"},{"title":"List of users","api":"POST https://api.sendforsign.com/api/user","href":"/api-reference/user/list"}]},{"group":"Contract","pages":[{"title":"Create contract","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/create"},{"title":"Create from template","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/create-from-template"},{"title":"Create and send contract","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/create-send"},{"title":"Create and fill in contract","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/create-fill"},{"title":"Update contract","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/update"},{"title":"Read contract","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/read"},{"title":"Duplicate contract","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/duplicate"},{"title":"List of contracts","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/list"},{"title":"Archive contract","api":"POST https://api.sendforsign.com/api/contract","href":"/api-reference/contract/archive"},{"title":"Get Timeline","api":"GET https://api.sendforsign.com/api/contract_event","href":"/api-reference/contract/get_timeline"}]},{"group":"PDF and Word","pages":[{"title":"Download PDF","api":"GET https://api.sendforsign.com/api/download_pdf","href":"/api-reference/pdf/download"},{"title":"Upload PDF","api":"POST https://api.sendforsign.com/api/upload_pdf","href":"/api-reference/pdf/upload"},{"title":"Download Word","api":"GET https://api.sendforsign.com/api/download_docx","description":"Download a text contract as a Microsoft Word (.docx) file with the Sendforsign API.","href":"/api-reference/pdf/downloadword"}]},{"group":"Placeholder","pages":[{"title":"Create placeholder","api":"POST https://api.sendforsign.com/api/placeholder","href":"/api-reference/placeholder/create"},{"title":"Update placeholder","api":"POST https://api.sendforsign.com/api/placeholder","description":"Update a placeholder's name, value or who fills it in (fillingType) via the Sendforsign API.","href":"/api-reference/placeholder/update"},{"title":"Table placeholder","api":"POST https://api.sendforsign.com/api/placeholder","href":"/api-reference/placeholder/update-table"},{"title":"Place basic placeholder","api":"POST https://api.sendforsign.com/api/placeholder","href":"/api-reference/placeholder/pdfbasic"},{"title":"Place special placeholder","api":"POST https://api.sendforsign.com/api/placeholder","href":"/api-reference/placeholder/pdfspecial"},{"title":"List of placeholders","api":"POST https://api.sendforsign.com/api/placeholder","href":"/api-reference/placeholder/list"},{"title":"Delete placeholder","api":"POST https://api.sendforsign.com/api/placeholder","href":"/api-reference/placeholder/delete"}]},{"group":"Recipient","pages":[{"title":"Create recipient","api":"POST https://api.sendforsign.com/api/recipient","href":"/api-reference/recipient/create"},{"title":"Update recipient","api":"POST https://api.sendforsign.com/api/recipient","href":"/api-reference/recipient/update"},{"title":"Send to recipients","api":"POST https://api.sendforsign.com/api/recipient","href":"/api-reference/recipient/send"},{"title":"List of recipients","api":"POST https://api.sendforsign.com/api/recipient","href":"/api-reference/recipient/list"},{"title":"Delete recipient","api":"POST https://api.sendforsign.com/api/recipient","href":"/api-reference/recipient/delete"}]},{"group":"Template","pages":[{"title":"Create template","api":"POST https://api.sendforsign.com/api/template","href":"/api-reference/template/create"},{"title":"Create and fill in template","api":"POST https://api.sendforsign.com/api/template","href":"/api-reference/template/create-fill"},{"title":"Update template","api":"POST https://api.sendforsign.com/api/template","href":"/api-reference/template/update"},{"title":"Convert into template","api":"POST https://api.sendforsign.com/api/template","href":"/api-reference/template/convert"},{"title":"Read template","api":"POST https://api.sendforsign.com/api/template","href":"/api-reference/template/read"},{"title":"Duplicate template","api":"POST https://api.sendforsign.com/api/template","href":"/api-reference/template/duplicate"},{"title":"List of templates","api":"POST https://api.sendforsign.com/api/template","href":"/api-reference/template/list"},{"title":"Delete template","api":"POST https://api.sendforsign.com/api/template","href":"/api-reference/template/delete"}]},{"group":"Webhook","pages":[{"title":"Webhooks concept","href":"/api-reference/webhook/concept"},{"title":"Create webhook","api":"POST https://api.sendforsign.com/api/webhook","href":"/api-reference/webhook/create"},{"title":"Update webhook","api":"POST https://api.sendforsign.com/api/webhook","href":"/api-reference/webhook/update"},{"title":"Read webhook","api":"POST https://api.sendforsign.com/api/webhook","href":"/api-reference/webhook/read"},{"title":"List of webhooks","api":"POST https://api.sendforsign.com/api/webhook","href":"/api-reference/webhook/list"},{"title":"Delete webhook","api":"POST https://api.sendforsign.com/api/webhook","href":"/api-reference/webhook/delete"}]},{"group":"Settings","pages":[{"title":"Email notifications","api":"POST https://api.sendforsign.com/api/settings","href":"/api-reference/settings/email_notifications"},{"title":"Custom branding","api":"POST https://api.sendforsign.com/api/settings","href":"/api-reference/settings/branding"}]}]},{"tab":"React Components","pages":[{"title":"React Components","href":"/sdk/introsdk"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026"}]},{"tab":"About","pages":[{"title":"About","href":"/about/vision"}]}]},"basePath":"","title":"Create placeholder - Sendforsign documentation","deploymentId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","buildId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-GKHRyhW5.js","utils-CXMoydtj.js","cloneDeep-Cl7CR73B.js","_Uint8Array-7sQhd3aE.js","isObject-FP1Yky1u.js","utils-ABJ_F6Yn.js","addUniqueKeysToSchema-B7v39GOQ.js","snippetPresets-CgibLHmh.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C2n3VqMC.js","isEqual-BKe3Q7nP.js","usePlaygroundInputsStore-Iji6acs6.js","shallow-Db9K5ulX.js","getApiPlaygroundDisplay-BGnJQBSj.js","CodeSnippet-DlQqWRja.js","CodeSnippets-JF3Bj6-U.js","Page-Ctn-BHcp.js","getPastedJson-B0pIrOza.js","icon-UPBYC1Wr.js","MethodPill-CoVRW5MG.js","DuplicateIcon-BuNnsqwg.js","createIcon-Cj9cJegl.js","DynamicMarkdown-C_R66tyH.js","SectionHeading-C6RB-y9f.js","axios-vUo_bRtp.js"]}