SignNow Integration with SmythOS
Want to automate your agreement and contract workflows? Connect SignNow to SmythOS and empower your agents to automatically send documents for electronic signature.
List of SignNow Components
Quickly compare SignNow components by what they do and their key I/O.
Component | Action | What it Does | Inputs | Key Outputs | Use Case |
---|---|---|---|---|---|
Send for Signature | Write | Sends a document from your SignNow account to a recipient to be signed. | required document_id , to , from , subject | id | Sending a sales contract to a new client for their signature. |
Prerequisites
Before you begin, please ensure you have the following:
- An active SmythOS account. (Sign up here).
- A SignNow account.
- Your SignNow Access Token.
- A pre-uploaded document or template in your SignNow account to get a
document_id
.
Getting Started With SignNow
The connection between SmythOS and SignNow is configured using a secure Access Token.
Step 1: Get Your SignNow Access Token
- Log in to your SignNow account.
- Navigate to the API section in your dashboard or account settings. The direct link is
https://app.signnow.com/webapp/api-dashboard/keys
. - In the API dashboard, you can create and manage your applications and generate an Access Token.
- Copy the generated token to your clipboard.
Step 2: Store Your Access Token in SmythOS Vault
Your Access Token is a sensitive credential. Use the SmythOS Vault
to store it securely.
- In your SmythOS dashboard, navigate to the Vault.
- Create a new secret and paste your SignNow Access Token as the value. Give it a memorable name, like
signnow_access_token
. - For more details, see the Vault Documentation.
Step 3: Configure a SignNow Component
- In your SmythOS agent graph, drag and drop the Send E-docs for Signature component.
- Click the component to open its Settings panel.
- In the
Access Token
field, select the secret you saved in the Vault (e.g.,signnow_access_token
). - Your connection is now configured for that component.
Which SignNow Component Should I Use?
If you need to… | Target | Use this Component | Why this one? |
---|---|---|---|
Send a document out for signature | A document_id and a recipient's email | Send for Signature | This is the core component for initiating the e-signature process for a document. |
Component Details
This section provides detailed information for the SignNow component.
Send for Signature
Sends an invitation to a recipient to sign a specific document that exists in your SignNow account. (Formerly "Send E-docs for Signature").
Inputs
Field | Type | Required | Notes |
---|---|---|---|
document_id | string | Yes | The unique ID of the document in your SignNow account that you want to send. |
to | string | Yes | The email address of the person who needs to sign the document. |
from | string | Yes | The email address the invitation will be sent from. This should be an address associated with your account. |
subject | string | Yes | The subject line for the signature invitation email. |
message | string | Yes | The body content of the invitation email. |
Outputs
Field | Type | Description |
---|---|---|
id | string | A unique identifier for the signature invitation transaction. |
Response | object | The full, raw JSON response from the SignNow API, confirming the invite was sent. |
Headers | object | The HTTP headers from the API response. |
{
"component": "signnow.sendEdocsForSignature",
"document_id": "0a1b2c3d4e5f6a7b8c9d0e1f",
"to": "client@example.com",
"from": "sales@mycompany.com",
"subject": "Your Service Agreement is Ready to Sign",
"message": "Hello, please review and sign the attached service agreement at your earliest convenience. Thank you!"
}
Best Practices & Advanced Tips
- Secure Your Access Token: Always store your SignNow Access Token in the SmythOS
Vault
. - Use Templates: For documents you send frequently (like contracts or NDAs), use SignNow's template feature. You can create a template with pre-defined signature fields. Your agent can then send an invitation to sign a new copy of that template.
- Track Document Status with Webhooks: While these components initiate the flow, the most powerful automation comes from using SignNow webhooks. You can configure a webhook in SignNow to call a SmythOS agent endpoint whenever a document is viewed, signed, or completed, allowing your agent to react in real-time.
- Dynamic Documents: For more advanced workflows, you can use the SignNow API to first create a document from a template and merge fields with customer data (e.g., name, address), then get that new
document_id
and send it for signature, all within one agent.
Troubleshooting Common Issues
-
Error:
401 Unauthorized
- Cause: The Access Token is incorrect, has expired, or is missing from the request.
- Solution: Verify that the Access Token in your SmythOS Vault is correct and active. Generate a new token in your SignNow API settings if necessary and update your Vault secret.
-
Error:
404 Not Found
- Cause: The
document_id
provided does not exist in your SignNow account. - Solution: Log in to your SignNow account and verify the document ID is correct. Ensure the document hasn't been deleted.
- Cause: The
-
Emails Not Being Received
- Cause: The recipient's email server may be blocking emails from SignNow, or the email may be in their spam folder. It could also be a deliverability issue with the
from
address. - Solution: Ask the recipient to check their spam/junk folder. Ensure the
from
email address is a valid address that you control.
- Cause: The recipient's email server may be blocking emails from SignNow, or the email may be in their spam folder. It could also be a deliverability issue with the
What's Next?
You are now ready to build powerful document signing workflows with the SmythOS SignNow Integration!
Consider these ideas:
-
Build an Agent That...
- Manages new employee onboarding. When a new employee is added to your HR system, the agent automatically sends their employment contract from a SignNow template for them to sign.
- Automates sales contracts. When a deal is moved to the "Contract Sent" stage in your CRM, the agent sends the contract to the client via SignNow. When the contract is signed (detected via webhook), the agent updates the CRM stage to "Closed-Won."
- Handles vendor agreements. Your agent can receive a new vendor agreement via email, upload it to SignNow (via a custom API call), and then use this component to send it to the appropriate manager for their signature.
-
Explore Other Integrations:
- Combine SignNow with a database integration like Firestore. When a document is sent for signature, log the invitation
id
and status in a Firestore document for auditing. - Use an LLM component to generate a custom legal clause, add it to a contract template, and then send it for signature with SignNow.
- When a contract is signed, trigger an agent to create a new project in Asana and a new customer record in Stripe.
- Combine SignNow with a database integration like Firestore. When a document is sent for signature, log the invitation