openapi: 3.0.3 info: title: Zoho Writer Combine Signatures API description: REST API for programmatic document creation, editing, mail merge, electronic signing, webhook automation, and multi-format document export. Supports Document, Combine, Merge, and Sign API categories with OAuth 2.0 authentication. version: 1.0.0 contact: name: Zoho Writer Support email: support@zohowriter.com url: https://www.zoho.com/writer/help/api/v1/ termsOfService: https://www.zoho.com/writer/developers.html license: name: Zoho API Terms url: https://www.zoho.com/writer/developers.html servers: - url: https://www.zohoapis.com/writer/api/v1 description: United States (default) - url: https://www.zohoapis.eu/writer/api/v1 description: Europe - url: https://www.zohoapis.in/writer/api/v1 description: India - url: https://www.zohoapis.jp/writer/api/v1 description: Japan - url: https://www.zohoapis.com.au/writer/api/v1 description: Australia - url: https://www.zohoapis.ca/writer/api/v1 description: Canada - url: https://www.zohoapis.sa/writer/api/v1 description: Saudi Arabia - url: https://www.zohoapis.com.cn/writer/api/v1 description: China - url: https://www.zohoapis.sg/writer/api/v1 description: Singapore security: - OAuth2: - ZohoWriter.documentEditor.ALL - ZohoPC.files.ALL - WorkDrive.files.ALL tags: - name: Signatures description: Electronic signature workflows via Zoho Sign paths: /documents/{document_id}/merge/sign: post: operationId: mergeAndSign summary: Merge and sign description: Merge a document with data and send the result for electronic signature collection via Zoho Sign. tags: - Signatures security: - OAuth2: - ZohoWriter.documentEditor.ALL - ZohoWriter.merge.ALL - ZohoPC.files.ALL - WorkDrive.files.ALL parameters: - name: document_id in: path required: true schema: type: string description: Unique identifier for the Writer document requestBody: required: true content: multipart/form-data: schema: type: object required: - service_name - filename properties: service_name: type: string enum: - zohosign description: Signing service provider filename: type: string description: Name for the signed document merge_data: type: object merge_data_csv_content: type: string format: binary merge_data_json_content: type: string format: binary merge_data_csv_url: type: string format: uri merge_data_json_url: type: string format: uri record_id: type: string maxLength: 25 signer_data: type: array description: Array of signer details including action types and verification items: type: object sign_in_order: type: boolean description: Enforce signing sequence message: type: string description: Message for signers set_expire: type: integer maximum: 99 description: Expiration in days (max 99) reminder_period: type: integer description: Reminder interval in days common_attachments: type: string format: binary description: Shared attachments (max 20 files, 40 MB total) test_mode: type: boolean responses: '200': description: Merge and sign job details content: application/json: schema: type: object properties: merge_report_url: type: string format: uri records: type: array items: type: object properties: sign_request_id: type: string status: type: string externalDocs: description: Merge and Sign url: https://www.zoho.com/writer/help/api/v1/merge-and-sign.html /templates/{template_id}/bulkmerge/sign: post: operationId: bulkMergeAndSign summary: Bulk merge and sign description: Perform bulk merge and sign operations using a template. tags: - Signatures security: - OAuth2: - ZohoWriter.documentEditor.ALL - ZohoWriter.merge.ALL parameters: - name: template_id in: path required: true schema: type: string description: Unique identifier for the template requestBody: required: true content: multipart/form-data: schema: type: object properties: merge_data: type: object merge_data_csv_content: type: string format: binary merge_data_json_content: type: string format: binary merge_data_csv_url: type: string format: uri merge_data_json_url: type: string format: uri signer_data: type: array items: type: object service_name: type: string enum: - zohosign test_mode: type: boolean responses: '200': description: Bulk merge and sign job initiated content: application/json: schema: $ref: '#/components/schemas/MergeResponse' externalDocs: description: Bulk Sign url: https://www.zoho.com/writer/help/api/v1/bulkmerge-sign.html components: schemas: MergeRecord: type: object properties: data: type: object description: Input merge data for this record download_link: type: string format: uri document_id: type: string document_url: type: string format: uri status: type: string enum: - inprogress - completed - failed MergeResponse: type: object properties: merge_report_data_url: type: string format: uri merge_report_url: type: string format: uri status: type: string enum: - inprogress - completed - failed records: type: array items: $ref: '#/components/schemas/MergeRecord' securitySchemes: OAuth2: type: oauth2 description: OAuth 2.0 authentication. Refer to https://www.zoho.com/writer/help/api/v1/oauth-2.html for setup. flows: authorizationCode: authorizationUrl: https://accounts.zoho.com/oauth/v2/auth tokenUrl: https://accounts.zoho.com/oauth/v2/token scopes: ZohoWriter.documentEditor.ALL: Full access to document editor operations ZohoWriter.merge.ALL: Full access to merge operations ZohoPC.files.ALL: Access to Zoho personal cloud files WorkDrive.files.ALL: Access to WorkDrive files WorkDrive.organization.ALL: Organization-level WorkDrive access WorkDrive.workspace.ALL: Workspace-level WorkDrive access externalDocs: description: Zoho Writer API Documentation url: https://www.zoho.com/writer/help/api/v1/