SpaceSign

Interact with the SpaceSign API

Field → Add Field

AI-generated

Summary

Adds field(s) to a SpaceSign document.

Inputs

  • documentId (required) — The ID of the document to add the field to.
  • fields (required) — Field definition(s) to create. At least one field must be provided. Each field supports metadata, position, size, type, and optional recipient association.

Output shape

The SpaceSign API response containing the created field data, delivered as the node's main output item.

The API endpoint is POST /documents/:documentId/fields. Fields are mapped from the fixedCollection, with type, position, dimensions, and recipientId passed as-is; fieldMetaJson is parsed into the API's fieldMeta structure. If no fields are provided, the node throws an error.

Examples

Example 1: Add a signature field to document doc_123 for recipient rec_456.

documentId: 'doc_123'; fields: [{ type: 'SIGNATURE', recipientId: 'rec_456', pageNumber: 1, pageX: 0, pageY: 0, pageWidth: 120, pageHeight: 32, fieldMetaJson: '{}' }]

Discussion