--- title: "Create freeform invite" method: POST path: "/v2/document-groups/{document_group_id}/free-form-invites" --- # Create freeform invite `POST /v2/document-groups/{document_group_id}/free-form-invites` ## Request - Base URL: `https://api.signnow.com` - URL: `https://api.signnow.com/v2/document-groups/{document_group_id}/free-form-invites` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) This endpoint allows API users to create and send a FreeForm invite to sign a document group. **FreeForm invite** A FreeForm invite is an invite with a document that does not contain fields; recipients can add their signature anywhere on the document. > [!NOTE] > A FreeForm invite can be sent to the sender's own email address. **Schedule a freeform invite** To send a FreeForm document group invite at a later time, use the [Schedule document group invite](/docs/scheduled-doc-group-invite/operations/post-document-group-scheduled-invite) endpoint with `is_freeform_invite: true`. > [!NOTE] > Custom `subject` and `message` require a paid API plan, an API free trial, or a Site License. On a free trial or without a paid subscription, `subject` can have up to `100` characters and `message` up to `200` characters. ## Request body - object - `cc` object[]: Array with the list of CC email addresses. - `email` string: CC recipient's email address. - `to` object[], required: Array with the list of signers. - `email` string, required: Signer's email address. **Note**: A FreeForm invite can be sent to the sender's own email address. - `language` string: Sets the language of the signing session and notification emails for the signer. Possible values: `en` for English, `es` for Spanish, and `fr` for French. If not set, the language is determined by the language of your SignNow account. If emails are branded, you can set up [your own](/docs/branding-email-resources#language-branding) email texts in different languages. - `redirect_uri` string: The link that opens after a signer signs the document group. This field overrides the general `redirect_uri`. - `redirect_target` string: Determines whether to open the redirect link in the new tab in the browser, or in the same tab after the signing session. Possible values: `blank` - opens the link in the new tab, `self` - opens the link in the same tab. - `close_redirect_uri` string: The link that opens after a signer selects the **Close** button. - `message` string: Email body message for all signers. Requires a paid API plan, an API free trial, or a Site License. Max `200` characters on a free trial or without a paid subscription. - `subject` string: Email subject for all signers. Requires a paid API plan, an API free trial, or a Site License. Max `100` characters on a free trial or without a paid subscription. - `redirect_uri` string: When the document is signed, the signer is redirected to this URI. - `client_timestamp` integer, required: UNIX timestamp. ## Response `201` The freeform invite was sent. - object - `data` object: The created freeform invite. - `id` string: ID of the document group freeform invite. ## Other responses - `400`: * Incorrect or missing token. * More than 20 documents in the document group. * Document group has no documents. * Document group has active fields. * Document group has deleted or trashed documents. * Owner cannot be a signer. * Invite has more than 50 signers. * User doesn't own the document group. * Missing `to` email. * `to` is not an array. * `to` is not an array of arrays. * `cc` is not an array. * `cc` is not an array of arrays. * `message` is not a string. * Empty `message`. * `message` is longer than 1000 characters. * `message` contains unsupported characters. * `subject` is not a string. * Empty `subject. * `subject` is longer than 1000 characters. * `subject` contains unsupported characters. * `redirect_uri` is not a string. * Empty `redirect_uri`. * `redirect_uri` is not a correct URL. * `redirect_uri` is longer than 2048 characters. * Missing `to.email`. * `to.email` is not a string. * Empty `to.email`. * `to. email` is not a correct email address. * Missing `cc.email`. * `cc.email` is not a string. * Empty `cc.email`. * `cc. email` is not a correct email address. * Emails in `to` are not unique. * Emails in `cc` are not unique. * Invite has more than 50 signers. * Invite has more than 50 emails in `cc`. * Missing `client_timestamp`. * `client_timestamp` is not an integer. * `client_timestamp` is out of range. * `language` is not a string. * Incorrect `language`. * `to.close_redirect_uri` is not a string. * Empty `to.close_redirect_uri`. * `to.close_redirect_uri` is not a correct URL address. * `to.close_redirect_uri` is longer than 2048 characters. * `to.redirect_uri` is not a string. * Empty `to.redirect_uri`. * `to.redirect_uri` is not a correct URL address. * `to.redirect_uri` is longer than 2048 characters. * `redirect_target` is not a string. * Incorrect `redirect_target`. * One of redirect URLs is required if `redirect_target` is added. * Custom `subject` or `message` without a paid API plan, an API free trial, or a Site License. * `subject` is longer than `100` characters or `message` is longer than `200` characters (on a free trial or without a paid subscription). - `403`: User is not verified. - `422`: Document group has active invites. - `429`: Too many requests. --- [API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)