Document Templates (GET, PATCH, POST)

Access document template actions, including template creation with the Document Template Designer.

Resource

1/connect/docgen/document-templates

GET Example

1https://yourInstance.salesforce.com/services/data/v65.0/connect/docgen/document-templates?offset=${offset}&limit=${limit}&searchString=${searchString}

PATCH Example

1https://yourInstance.salesforce.com/services/data/v65.0/connect/docgen/document-templates?documentTemplateId=${documentTemplateId}

POST Example

1https://yourInstance.salesforce.com/services/data/v65.0/connect/docgen/document-templates?documentTemplateId=${documentTemplateId}&action=${action}

Available version

60.0

HTTP methods

GET, PATCH, POST

Request parameters for GET

Parameter Name	Type	Description	Required or Optional	Available Version
`limit`	String	Number of document templates per page. The default value is 20.	Optional	60.0
`offset`	String	Number of records to skip. The default value is 0.	Optional	60.0
`searchString`	String	Search term that is used to retrieve a list of document templates.	Optional	60.0

Response body for GET

Document Template List

Request body for PATCH

JSON example

1{
2  "isActive": "false",
3  "status": "Draft",
4  "documentGenerationMechanism": "ClientSide",
5  "extractOmniDataTransformName": "Extractor",
6  "mapperOmniDataTransformName": "Mapper",
7  "shouldDisplayUnmappedToken": "false",
8  "tokenList": "token1,token2,token3",
9  "tokenMappingMethodType": "ContextService",
10  "contextDefinitionName": "QuoteProposal",
11  "contextMappingName": "QuoteToContextMapping",
12  "usageType": "Contract_Lifecycle_Management",
13  "contentDocumentId": "069xxxxxxxxxxxxxxx"
14}

Properties

Name	Type	Description	Required or Optional	Available Version
`contentDocumentId`	String	ID of the document associated with a document template.	Optional	60.0
`contextDefinitionName`	String	Name of the context definition that contains the mapping details used for extraction in the Context Service token mapping type.	Required if the tokenMappingMethodTypeproperty is set to `ContextService`.	64.0
`contextMappingName`	String	Name of the context mapping used for extraction in the Context Service token mapping type.	Required if the tokenMappingMethodTypeproperty is set to `ContextService`.	64.0
`documentGenerationMechanism`	String	Specifies the method for generating the document. Possible values are: `Client-side` `Server-side` The default value is `Client-side`.	Optional	60.0
`extractOmniDataTransformName`	String	Name of the OmniDataTransform bundle of the extract type.	Optional	60.0
`isActive`	Boolean	Indicates whether the document template is set to active (`true`) or inactive (`false`).	Optional	60.0
`mapperOmniDataTransformName`	String	Name of the OmniDataTransform bundle of the mapper type.	Optional	60.0
`shouldDisplayUnmappedToken`	Boolean	Indicates whether the document template unmapped tokens be displayed (`true`) or not (`false`).	Optional	60.0
`status`	String	Status to be set for the document template.	Optional	60.0
`tokenList`	String	List of tokens present in the document template.	Optional	60.0
`tokenMappingMethodType`	String	Processing method for data that can originate from the same source object. Possible values are: `ContextService` `OmniDataTransform` The default value is `ContextService`	Required	60.0
`usageType`	String	Usage type of the document template.	Optional	60.0

Request parameters for PATCH

Parameter Name	Type	Description	Required or Optional	Available Version
`documentTemplateId`	String	ID of the document template for operations like cloning or creating a new version.	Required	60.0
`documentTemplateUpdateInput`	Object	Specifies the details to modify an existing document template.	Optional	64.0

Response body for PATCH

Document Template

Request body for POST

JSON example

1{
2  "name": "TemplateName",
3  "type": "MicrosoftWord/MicrosoftPowerpoint/Microsoft365Word",
4  "tokenMappingMethodType": "OmniDataTransform",
5  "tokenMappingType": "JSON",
6  "extractOmniDataTransformName": "ExtractName",
7  "mapperOmniDataTransformName": "MapperName",
8  "contentDocumentId": "069xx0000004CyeAAE",
9  "documentGenerationMechanism": "ServerSide",
10  "usageType": "Contract_Lifecycle_Management",
11  "tokenList": "token1,token2,token3"
12}

JSON example with Context Service as TokenMappingMethodType

1{
2  "name": "TemplateName",
3  "type": "MicrosoftWord/MicrosoftPowerpoint/Microsoft365Word",
4  "tokenMappingMethodType": "ContextService",
5  "contextDefinitionName": "QuoteProposal",
6  "contextMappingName": "QuoteToContextMapping",
7  "tokenMappingType": "JSON",
8  "extractOmniDataTransformName": "ExtractName",
9  "mapperOmniDataTransformName": "MapperName",
10  "contentDocumentId": "069xx0000004CyeAAE",
11  "documentGenerationMechanism": "ClientSide",
12  "usageType": "Contract_Lifecycle_Management",
13  "tokenList": "token1,token2,token3"
14}

Properties

Name	Type	Description	Required or Optional	Available Version
`contentDocumentId`	String	ID of the Document associated with a document template.	Optional	60.0
`contextDefinitionName`	String	Name of the context definition that contains the mapping details used for extraction in the Context Service token mapping type.	Required if the tokenMappingMethodTypeproperty is set to `ContextService`.	64.0
`contextMappingName`	String	Name of the context mapping used for extraction in the Context Service token mapping type.	Required if the tokenMappingMethodTypeproperty is set to `ContextService`.	64.0
`documentGenerationMechanism`	String	Specifies the method for generating the document. Possible values are: `Client-side` `Server-side` The default value is `Client-side`.	Optional	60.0
`extractOmniDataTransformName`	String	Name of the OmniDataTransform bundle of the extract type.	Optional	60.0
`mapperOmniDataTransformName`	String	Name of the OmniDataTransform bundle of the mapper type.	Optional	60.0
`name`	String	Name of the document template.	Required	60.0
`tokenList`	String	List of tokens present in the document template.	Optional	60.0
`tokenMappingMethodType`	String	Processing method for the data that can originate from same source object. Possible values are: `ContextService` `OmniDataTransform` The default value is `ContextService`.	Required	60.0
`tokenMappingType`	String	Mapping type for tokens of the document template.	Required	60.0
`type`	String	Type of document template.	Required	60.0
`usageType`	String	Usage type of the document template.	Optional	60.0

Request parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
`action`	String	Action to be performed on the document template. Possible values are: `Clone` `NewVersion`	Optional	60.0
`documentTemplate`	Object	Specifies the details of a new document template resource.	Optional	64.0
`documentTemplateId`	String	ID of the document template for operations like cloning or creating a new version.	Optional	60.0

Response body for POST

Document Template

Salesforce Contracts

Document Templates (GET, PATCH, POST)