signNow
Create documents and send signing invites with signNow.
On this page
Connect
Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.
- In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
- For every project in a workspace: Workspace settings, Integrations.
- Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.
Call it from a workflow
Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.
// .workflow.js (native ctx)
export async function run(ctx) {
const res = await ctx.integrations.invoke("sign-now", "send_invite", {
"document_id": "<document id>",
"from": "<sender's email>",
"signers": []
});
if (!res.success) throw new Error(res.error);
ctx.log.info("signNow answered", { output: res.output });
}// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";
export default defineWorkflow({
id: "sign-now-send-invite",
name: "signNow: Invite to Sign",
description: "Calls signNow when a row is created.",
trigger: { type: "entity_event", entity: "tickets", event: "created" },
async run(ctx, event) {
const res = await ctx.integrations.call("sign-now", {
"action": "send_invite",
"document_id": "<document id>",
"from": "<sender's email>",
"signers": []
}) as { success: boolean; error?: string };
if (!res.success) throw new Error(res.error);
},
});curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/sign-now/send_invite" \
-H "Authorization: Bearer $APP_KEY" \
-H "content-type: application/json" \
-d '{"props":{"document_id":"<document id>","from":"<sender's email>","signers":[]}}'Actions
send_invitein catalog
Invite to Sign. Sends an invite to sign an existing document.
| Input | Type | Description |
|---|---|---|
document_idrequired | text | The ID of the document to send for signing. |
fromrequired | text | Must be the email address associated with your SignNow account. |
signersrequired | array | One entry per signer role. Each signer needs an email, role name, and signing order. |
subjectoptional | text | Default email subject for all signers. Overridden by per-signer subject if set. |
messageoptional | long text | Default email body for all signers. Overridden by per-signer message if set. |
ccoptional | array | Email addresses to CC on the invite. |
cc_subjectoptional | text | Subject line for CC recipient emails. |
cc_messageoptional | long text | Body message for CC recipient emails. |
cancel_invite
Cancel Invite to Sign. Cancels an invite to sign a document.
| Input | Type | Description |
|---|---|---|
document_idrequired | text | The ID of the document whose invite you want to cancel. |
reasonrequired | text | The reason for cancelling the invite. |
create_document_from_template_and_send_invite
Create Document From Template & Send Free Form Invite. Creates a new document from a template and sends a free form invite to a signer.
| Input | Type | Description |
|---|---|---|
template_idrequired | text | The ID of the template to create the document from. |
document_nameoptional | text | Name for the new document. Defaults to the template name if not provided. |
torequired | text | Email address of the signer. A free form invite can be sent to the sender's own email address. |
fromrequired | text | Must be the email address associated with your SignNow account. |
subjectoptional | text | Subject line of the invite email sent to the signer. |
messageoptional | long text | Body message of the invite email sent to the signer. |
ccoptional | array | Email addresses to CC on the invite. |
cc_subjectoptional | text | Subject line of the email sent to CC recipients. |
cc_messageoptional | long text | Body message of the email sent to CC recipients. |
languageoptional | one of "en" | "es" | "fr" | Language for the signing session and notification emails. |
redirect_urioptional | text | URL the signer is redirected to after signing. |
close_redirect_urioptional | text | URL that opens when the signer clicks the Close button. |
redirect_targetoptional | one of "blank" | "self" | Whether to open the redirect URL in a new tab or the same tab. |
create_document_from_template_and_send_role_based_invite
Create Document From Template & Send Role-Based Invite. Creates a new document from a template with fillable fields and sends an invite to one or more signers by role.
| Input | Type | Description |
|---|---|---|
template_idrequired | text | The ID of the template to create the document from. |
document_nameoptional | text | Name for the new document. Defaults to the template name if not provided. |
fromrequired | text | Must be the email address associated with your SignNow account. |
signersrequired | array | One entry per signer role defined in the template. Each signer must have an email and a role name (e.g. "Signer 1"). |
subjectoptional | text | Default email subject sent to all signers. Overridden by per-signer subject if set. |
messageoptional | long text | Default email body sent to all signers. Overridden by per-signer message if set. |
ccoptional | array | Email addresses to CC on the invite. |
cc_subjectoptional | text | Subject line for CC recipient emails. |
cc_messageoptional | long text | Body message for CC recipient emails. |
expiration_daysoptional | number | Number of days before the invite expires (3–180). Defaults to 30. |
languageoptional | one of "en" | "es" | "fr" | Language for the signing session and notification emails. |
create_document_group_from_template_and_send_invite
Create Document Group From Template Group & Send Invite. Creates a new document group from a template group and sends an invite to one or more signers.
| Input | Type | Description |
|---|---|---|
template_idrequired | text | The unique ID of the document group template. |
group_namerequired | text | Name for the new document group. |
signersrequired | array | One entry per signer. Each signer needs an email, role name, and the document they are signing within the group. Signing order determines the step sequence. |
ccoptional | array | Email addresses to CC on the invite. |
custom_api_call
Custom API Call. Make a custom authenticated request to any SignNow API endpoint.
| Input | Type | Description |
|---|---|---|
urlrequired | object (depends on other props) | url |
methodrequired | one of "GET" | "POST" | "PATCH" | "PUT" | "DELETE" | "HEAD" | Method |
headersrequired | object | Authorization headers are injected automatically from your connection. |
queryParamsrequired | object | Query Parameters |
body_typeoptional | one of "none" | "json" | "form_data" | "raw" | Body Type |
bodyoptional | object (depends on other props) | Body |
response_is_binaryoptional | boolean | Enable for files like PDFs, images, etc. |
failsafeoptional | boolean | No Error on Failure |
timeoutoptional | number | Timeout (in seconds) |
followRedirectsoptional | boolean | Follow redirects |
upload_document
Upload Document. Uploads a document to your SignNow account. Supports PDF, Word, PowerPoint, Excel, images, and more.
| Input | Type | Description |
|---|---|---|
filerequired | file | The file to upload. Accepted formats: .pdf, .doc, .docx, .odt, .rtf, .png, .jpg, .jpeg, .gif, .bmp, .xml, .xls, .xlsx, .ppt, .pptx, .ps, .eps. Maximum size: 50 MB. |
check_fieldsoptional | boolean | Enable if your document contains simple text tags that should be converted to fillable fields. |
upload_document_and_extract_fields
Upload Document & Extract Fields. Uploads a document and automatically converts text tags into SignNow fillable fields.
| Input | Type | Description |
|---|---|---|
filerequired | file | The file to upload. Text tags in the document (e.g. {{t:s;r:y;o:"Signer 1";}}) will be converted to fillable fields. Accepted formats: .pdf, .doc, .docx, .odt, .rtf, .png, .jpg, .jpeg, .gif, .bmp, .x… |
Details
- Id
sign-now- Category
- Other
- Tags
- e-signature, documents, signing
- Package
@activepieces/piece-sign-now@0.0.2- Tier
- Community