Special placeholders are four types of placeholders that are created automatically for every recipient.
So, before placing special fields in your PDF contract, create a recipient using this request.
After this, all the special placeholders will be created automatically with corresponding keys:
Recipient_Key_1, Recipient_Key_2, Recipient_Key_3, Recipient_Key_4.Here’s an example of a placeholder key: "placeholderKey": "93447fb5-91ee-41ad-9f73-b4ae2d467292_4".Available placeholder codes:
1: Recipient’s date signed.
2: Recipient’s full name.
3: Recipient’s email.
4: Recipient’s signature.
Body parameters
object
required
Show child attribute
string
required
Action type.
string
required
Key of the client.
string
required
Key of the contract.
array
required
Array of placeholders.
Show child attribute
string
required
Key of the placeholder that needs to be updated. Generated automatically from 2 paramaters: Recipient’s Key and Special Type.
boolean
required
True for special fields.
string
required
Use the following placeholder codes to create the corresponding fields:
1: Recipient’s date signed,
2: Recipient’s full name
3: Recipient’s email
4: Recipient’s signature
array
Array of places.
Show child attribute
string
ID of the insertion. Provide a new ID for each insertion. If you provide the ID of an existing
placeholder, the placeholder will be updated.
string
Page number where you insert the placeholder, starting from 0.
string
Width of the placeholder.
string
Height of the placeholder.
string
Position X of the placeholder, starting from the top-left corner of the page.
string
Position Y of the placeholder, starting from the top-left corner of the page.
{"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/pdfspecial","slug":"/api-reference/placeholder/pdfspecial","pageMetadata":{"title":"Place special placeholder","api":"POST https://api.sendforsign.com/api/placeholder","description":"Place special placeholders in a PDF contract via the Sendforsign API: each recipient's signature, full name, email and date signed.","href":"/api-reference/placeholder/pdfspecial"},"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: \"Place special placeholders in a PDF contract via the Sendforsign API: each recipient’s signature, full name, email and date signed.\"\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`,li:`li`,p:`p`,ul:`ul`,..._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:[`Special placeholders are four types of placeholders that are created automatically for every recipient.\nSo, before placing special fields in your PDF contract, create a recipient using `,_jsx(_components.a,{href:`/api-reference/recipient/create`,children:`this request`}),`.\nAfter this, all the special placeholders will be created automatically with corresponding keys:\n`,_jsx(_components.code,{children:`Recipient_Key_1`}),`, `,_jsx(_components.code,{children:`Recipient_Key_2`}),`, `,_jsx(_components.code,{children:`Recipient_Key_3`}),`, `,_jsx(_components.code,{children:`Recipient_Key_4`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Here’s an example of a placeholder key: `,_jsx(_components.code,{children:`\"placeholderKey\": \"93447fb5-91ee-41ad-9f73-b4ae2d467292_4\"`}),`.`]}),`\n`,_jsx(_components.p,{children:`Available placeholder codes:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`1`}),`: Recipient’s date signed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`2`}),`: Recipient’s full name.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`3`}),`: Recipient’s email.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`4`}),`: Recipient’s signature.`]}),`\n`]}),`\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:`placeholders`,type:`array`,required:true,id:`param-placeholders`,children:[_jsx(_components.p,{children:`Array of placeholders.`}),_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ParamField,{body:`placeholderKey`,type:`string`,required:true,id:`param-placeholder-key`,children:_jsx(_components.p,{children:`Key of the placeholder that needs to be updated. Generated automatically from 2 paramaters: Recipient’s Key and Special Type.`})}),_jsx(ParamField,{body:`isSpecial`,type:`boolean`,required:true,id:`param-is-special`,children:_jsx(_components.p,{children:`True for special fields.`})}),_jsx(ParamField,{body:`specialType`,type:`string`,required:true,id:`param-special-type`,children:_jsxs(_components.p,{children:[`Use the following placeholder codes to create the corresponding fields:\n`,_jsx(`b`,{children:`1`}),`: Recipient’s date signed,\n`,_jsx(`b`,{children:`2`}),`: Recipient’s full name\n`,_jsx(`b`,{children:`3`}),`: Recipient’s email\n`,_jsx(`b`,{children:`4`}),`: Recipient’s signature`]})}),_jsx(ParamField,{body:`insertion`,type:`array`,id:`param-insertion`,children:_jsx(_components.p,{children:`Array of places.`})}),_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ParamField,{body:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`ID of the insertion. Provide a new ID for each insertion. If you provide the ID of an existing\nplaceholder, the placeholder will be updated.`})}),_jsx(ParamField,{body:`pageId`,type:`string`,id:`param-page-id`,children:_jsx(_components.p,{children:`Page number where you insert the placeholder, starting from 0.`})}),_jsx(ParamField,{body:`width`,type:`string`,id:`param-width`,children:_jsx(_components.p,{children:`Width of the placeholder.`})}),_jsx(ParamField,{body:`height`,type:`string`,id:`param-height`,children:_jsx(_components.p,{children:`Height of the placeholder.`})}),_jsx(ParamField,{body:`positionX`,type:`string`,id:`param-position-x`,children:_jsx(_components.p,{children:`Position X of the placeholder, starting from the top-left corner of the page.`})}),_jsx(ParamField,{body:`positionY`,type:`string`,id:`param-position-y`,children:_jsx(_components.p,{children:`Position Y of the placeholder, starting from the top-left corner of the page.`})})]})]})]})]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`placeholder`,type:`string`,id:`param-placeholder`,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":"Place special placeholder","api":"POST https://api.sendforsign.com/api/placeholder","description":"Place special placeholders in a PDF contract via the Sendforsign API: each recipient's signature, full name, email and date signed.","href":"/api-reference/placeholder/pdfspecial"}}},"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`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._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:[`Special placeholders are four types of placeholders that are created automatically for every recipient.\nSo, before placing special fields in your PDF contract, create a recipient using `,_jsx(_components.a,{href:`/api-reference/recipient/create`,children:`this request`}),`.\nAfter this, all the special placeholders will be created automatically with corresponding keys:\n`,_jsx(_components.code,{children:`Recipient_Key_1`}),`, `,_jsx(_components.code,{children:`Recipient_Key_2`}),`, `,_jsx(_components.code,{children:`Recipient_Key_3`}),`, `,_jsx(_components.code,{children:`Recipient_Key_4`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Here’s an example of a placeholder key: `,_jsx(_components.code,{children:`\"placeholderKey\": \"93447fb5-91ee-41ad-9f73-b4ae2d467292_4\"`}),`.`]}),`\n`,_jsx(_components.p,{children:`Available placeholder codes:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`1`}),`: Recipient’s date signed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`2`}),`: Recipient’s full name.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`3`}),`: Recipient’s email.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(`b`,{children:`4`}),`: Recipient’s signature.`]}),`\n`]}),`\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:`placeholders`,type:`array`,required:true,id:`param-placeholders`,children:[_jsx(_components.p,{children:`Array of placeholders.`}),_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ParamField,{body:`placeholderKey`,type:`string`,required:true,id:`param-placeholder-key`,children:_jsx(_components.p,{children:`Key of the placeholder that needs to be updated. Generated automatically from 2 paramaters: Recipient’s Key and Special Type.`})}),_jsx(ParamField,{body:`isSpecial`,type:`boolean`,required:true,id:`param-is-special`,children:_jsx(_components.p,{children:`True for special fields.`})}),_jsx(ParamField,{body:`specialType`,type:`string`,required:true,id:`param-special-type`,children:_jsxs(_components.p,{children:[`Use the following placeholder codes to create the corresponding fields:\n`,_jsx(`b`,{children:`1`}),`: Recipient’s date signed,\n`,_jsx(`b`,{children:`2`}),`: Recipient’s full name\n`,_jsx(`b`,{children:`3`}),`: Recipient’s email\n`,_jsx(`b`,{children:`4`}),`: Recipient’s signature`]})}),_jsx(ParamField,{body:`insertion`,type:`array`,id:`param-insertion`,children:_jsx(_components.p,{children:`Array of places.`})}),_jsxs(Expandable,{title:`child attribute`,children:[_jsx(ParamField,{body:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`ID of the insertion. Provide a new ID for each insertion. If you provide the ID of an existing\nplaceholder, the placeholder will be updated.`})}),_jsx(ParamField,{body:`pageId`,type:`string`,id:`param-page-id`,children:_jsx(_components.p,{children:`Page number where you insert the placeholder, starting from 0.`})}),_jsx(ParamField,{body:`width`,type:`string`,id:`param-width`,children:_jsx(_components.p,{children:`Width of the placeholder.`})}),_jsx(ParamField,{body:`height`,type:`string`,id:`param-height`,children:_jsx(_components.p,{children:`Height of the placeholder.`})}),_jsx(ParamField,{body:`positionX`,type:`string`,id:`param-position-x`,children:_jsx(_components.p,{children:`Position X of the placeholder, starting from the top-left corner of the page.`})}),_jsx(ParamField,{body:`positionY`,type:`string`,id:`param-position-y`,children:_jsx(_components.p,{children:`Position Y of the placeholder, starting from the top-left corner of the page.`})})]})]})]})]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`placeholder`,type:`string`,id:`param-placeholder`,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:`29`,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:`29`,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\": \"update\",`})}),`\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:` \"placeholders\": [`})}),`\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:` \"placeholderKey\": \"RECIPIENT_KEY_4\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"isSpecial\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"specialType\": 4,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"insertion\": [`})}),`\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:` \"action\": \"update\",`})}),`\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:` \"id\": 2,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"pageId\": 0,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"width\": 150,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"height\": 150,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"positionX\": 1,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"positionY\": 1`})}),`\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`,_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:`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:` \"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 updated\"`})]}),`\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":"Place special placeholder","api":"POST https://api.sendforsign.com/api/placeholder","description":"Place special placeholders in a PDF contract via the Sendforsign API: each recipient's signature, full name, email and date signed.","href":"/api-reference/placeholder/pdfspecial"}}}},"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=\"29\">\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\": \"update\",\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\"> \"placeholders\": [\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\"> \"placeholderKey\": \"RECIPIENT_KEY_4\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"isSpecial\": true,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"specialType\": 4,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"insertion\": [\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\"> \"action\": \"update\",\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\"> \"id\": 2,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"pageId\": 0,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"width\": 150,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"height\": 150,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"positionX\": 1,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"positionY\": 1\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\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=\"4\">\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 updated\"\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":"Place special 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}],"placeholders":[{"type":"array","items":[{"type":"object","properties":{"placeholderKey":[{"type":"string","description":"Key of the placeholder that needs to be updated. Generated automatically from 2 paramaters: Recipient’s Key and Special Type.","required":true}],"isSpecial":[{"type":"boolean","description":"True for special fields.","required":true}],"specialType":[{"type":"string","description":"Use the following placeholder codes to create the corresponding fields: : Recipient’s date signed, : Recipient’s full name : Recipient’s email : Recipient’s signature","required":true}],"insertion":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Array of places."}],"id":[{"type":"string","description":"ID of the insertion. Provide a new ID for each insertion. If you provide the ID of an existing placeholder, the placeholder will be updated."}],"pageId":[{"type":"string","description":"Page number where you insert the placeholder, starting from 0."}],"width":[{"type":"string","description":"Width of the placeholder."}],"height":[{"type":"string","description":"Height of the placeholder."}],"positionX":[{"type":"string","description":"Position X of the placeholder, starting from the top-left corner of the page."}],"positionY":[{"type":"string","description":"Position Y of the placeholder, starting from the top-left corner of the page."}]}}],"description":"Array of placeholders.","required":true}]},"required":true}]}}],"examples":{"example":{"value":{"data":{"action":"\u003cstring>","clientKey":"\u003cstring>","contractKey":"\u003cstring>","placeholders":[{"placeholderKey":"\u003cstring>","isSpecial":true,"specialType":"\u003cstring>","insertion":[{}],"id":"\u003cstring>","pageId":"\u003cstring>","width":"\u003cstring>","height":"\u003cstring>","positionX":"\u003cstring>","positionY":"\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":"Place special placeholder - Sendforsign documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T14:18:21.913Z","originalFileLocation":"api-reference/placeholder/pdfspecial.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=\"Place special placeholders in a PDF contract via the Sendforsign API: each recipient\u0026#x27;s signature, full name, email and date signed.\">\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=\"Place special placeholder - Sendforsign documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Place special placeholders in a PDF contract via the Sendforsign API: each recipient\u0026#x27;s signature, full name, email and date signed.\">\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/pdfspecial\">\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=Place+special+placeholder\u0026amp;description=Place+special+placeholders+in+a+PDF+contract+via+the+Sendforsign+API%3A+each+recipient%27s+signature%2C+full+name%2C+email+and+date+signed.\u0026amp;theme=dc911e1386ddeabcf1258e9f\u0026amp;signature=92de169f40ae057fc3077c4be876a7ce9924e7747725343b864f03a731c89a56\">\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=\"Place special placeholder - Sendforsign documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Place special placeholders in a PDF contract via the Sendforsign API: each recipient\u0026#x27;s signature, full name, email and date signed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sendforsign.mintlify.site/docs/_mintlify/api/og/v2?division=Placeholder\u0026amp;title=Place+special+placeholder\u0026amp;description=Place+special+placeholders+in+a+PDF+contract+via+the+Sendforsign+API%3A+each+recipient%27s+signature%2C+full+name%2C+email+and+date+signed.\u0026amp;theme=dc911e1386ddeabcf1258e9f\u0026amp;signature=92de169f40ae057fc3077c4be876a7ce9924e7747725343b864f03a731c89a56\">\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/pdfspecial\">\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/pdfspecial.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/pdfspecial#webpage\",\"url\":\"https://sendforsign.com/docs/api-reference/placeholder/pdfspecial\",\"name\":\"Place special placeholder\",\"description\":\"Place special placeholders in a PDF contract via the Sendforsign API: each recipient's signature, full name, email and date signed.\",\"dateModified\":\"2026-10-27T14:18:21.913Z\",\"isPartOf\":{\"@id\":\"https://sendforsign.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/pdfspecial#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/pdfspecial#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Placeholder\",\"item\":\"https://sendforsign.com/docs/api-reference/placeholder/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Place special placeholder\",\"item\":\"https://sendforsign.com/docs/api-reference/placeholder/pdfspecial\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/pdfspecial#apireference\",\"headline\":\"Place special placeholder\",\"name\":\"Place special placeholder\",\"description\":\"Place special placeholders in a PDF contract via the Sendforsign API: each recipient's signature, full name, email and date signed.\",\"url\":\"https://sendforsign.com/docs/api-reference/placeholder/pdfspecial\",\"mainEntityOfPage\":{\"@id\":\"https://sendforsign.com/docs/api-reference/placeholder/pdfspecial#webpage\"},\"dateModified\":\"2026-10-27T14:18:21.913Z\",\"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/pdfspecial.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","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","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","description":"Place a basic text placeholder at a position on a page of a PDF contract via the Sendforsign API.","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","description":"List all placeholders of a contract or template, with their values and who fills them in, via the Sendforsign API.","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":"Place special 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"]}