Actions16
- Document Actions
- Template Actions
- Recipient Actions
- Field Actions
Field → Add Field
AI-generatedSummary
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: '{}' }]