Create a draft form
You're viewing API version
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.POST
Create a blank form or an independent copy of templateId. The source template is unchanged. Copying a template additionally requires templates:read. Configure settings, document fields and parties through the form endpoints, then publish. Use Idempotency-Key when retrying creation.
header
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Idempotency-Key?stringMakes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
Length
length <= 255Body
application/json- body
templateId?stringLength
1 <= length201
application/json- response
id*stringtemplateId*stringworkspaceId*stringsenderUserId*stringrespondentSignerId*string|nullurl*stringenabled*booleanclosedReason*|Value in
"INCOMPLETE""MAX_SUBMISSIONS""EXPIRED""SENDER_LEFT"hasPassword*booleantitle*string|nulldescription*string|nullthankYouMessage*string|nullredirectUrl*string|nulldocumentExpiresInDays*numberexpiresAt*string|nullmaxSubmissions*number|nullsubmissionCount*numbercreatedAt*stringupdatedAt*stringquestions*array<||||||>Items
items <= 60slots*array<>publishIssues*array<>statistics*curl -X POST 'https://app.sajn.se/api/v1/forms' \ -H 'authorization: string' \ -H 'Content-Type: application/json' \ -d '{}'Example Response
{ "id": "string", "templateId": "string", "workspaceId": "string", "senderUserId": "string", "respondentSignerId": "string", "url": "string", "enabled": true, "closedReason": "INCOMPLETE", "hasPassword": true, "title": "string", "description": "string", "thankYouMessage": "string", "redirectUrl": "string", "documentExpiresInDays": 0, "expiresAt": "string", "maxSubmissions": 0, "submissionCount": 0, "createdAt": "string", "updatedAt": "string", "questions": [ { "id": "string", "label": "string", "placeholder": "string", "description": "string", "width": "full", "required": true, "kind": "name" } ], "slots": [ { "key": "string", "label": "string", "type": "string", "required": true, "options": [ "string" ] } ], "publishIssues": [ { "code": "string", "severity": "blocker", "message": "string" } ], "statistics": { "started": 0, "signed": 0 }}Was this page helpful?