How to Search Signed Contracts From Chat With the CloudSign API | Including Updating Document Information

CloudSign makes signing contracts faster, but once they are signed, finding out "when does that contract end?" or "how much was it for?" means opening documents one by one in the admin screen. Documents whose document information (counterparty, contract period, transaction amount, and so on) is still blank also tend to pile up. This article is for people in general affairs, legal, and sales administration who use CloudSign, and explains how to search signed documents from chat and how to check and correct their document information.

Bottom line

  • CloudSign has an official Web API. Using it requires a client ID, and according to the official help, the plans that can issue one are Standard, Corporate, Business, and Enterprise
  • Samurai App's CloudSign integration calls this Web API with each member's own client ID. The documents you can see are the same as your own permissions in CloudSign
  • From chat, you can view the list and contents of documents (recipients, status, file names) and view and update document information
  • You cannot send, remind, reject, or cancel documents, or create or download documents and files. Operations that move a contract forward are still done in the CloudSign screens as before

3 ways to look up CloudSign documents

CloudSign screens Call the Web API yourself Call it from an AI chat
Who can use it People with an account Companies on a plan that can issue a client ID Same as left, for companies that have enabled the integration in Samurai App
How you search Search and filters on screen Write a program Ask in words
How results are compiled A person copies them out A program formats them Returned as a table or text
Effort Grows with the number of documents Building and maintaining it Setup only at the start

Looking things up in the CloudSign screens is the baseline. While you have few documents, that is enough.

Calling the Web API yourself lets a program perform everything from creating to sending documents. CloudSign's official help describes the Web API as something "provided so that the operations from creating to sending documents, which have been done in a web browser on the CloudSign site, can be executed from a program." The specification is published on SwaggerHub, and calling it requires issuing a client ID in the admin screen. If the client ID item is not shown, Web API usage needs to be enabled on an eligible plan.

Calling it from an AI chat uses the same Web API as the second option without writing a program. Samurai App falls into this category.

What you can and cannot do in Samurai App

The six operations listed under "What you can do from chat" on the settings screen are everything.

View (only documents you can see)

  • Check which CloudSign user you are operating as
  • List your own documents. You can filter by status, such as draft, awaiting the other party, or signed. One page holds 100 documents, and you read the rest by specifying a page. You can also filter by the date a document was last processed
  • List your team's documents. This requires CloudSign's document management permission
  • Open one document and see its recipients (name, company name, email address, order, date and time processed, status), status, and list of files
  • View a document's document information: the management title, counterparty, signing date, contract start and end dates, cancellation notice deadline, whether it renews automatically, management number, and transaction amount

Update (by default, a confirmation appears before it runs)

  • Update a document's document information. Only the fields you change are sent, and the other fields stay as they are

What you cannot do

  • Send, remind, reject, or cancel documents
  • Create documents or files, or download PDFs and certificates of agreement
  • Read recipients' access codes, phone numbers, or signing URLs. These are not returned to the chat
  • Operate with someone else's client ID

The contents of files (the text of the contract) cannot be read. You can read up to the file names and page counts.

Looking up contract deadlines and amounts from document information

For signed documents whose document information includes the contract period and cancellation notice deadline, you can sort and read them in chat.

  • Pick out contracts with approaching deadlines. Ask, "Read the document information of the signed documents and make a table of the ones whose cancellation notice deadline is by next month, with the counterparty and whether they renew automatically," and it reads each document's information and builds the table
  • Total the transaction amounts per counterparty. You can ask something like, "Of the documents signed this year, total the transaction amounts of those whose counterparty is XX Inc." Documents with no amount in their document information are not included in the total, so having it show the count as well helps you notice what is missing
  • Fill in blanks. Ask, "List the documents whose counterparty in the document information is blank. Show the recipient's company name next to each as a candidate," then check the candidates before asking for the update

With many documents, reading the information one by one takes time. Narrowing the period with something like "this year" or "last month" reduces the number to read.

What you need

  • A CloudSign plan that can issue client IDs (Standard, Corporate, Business, or Enterprise according to the official help)
  • An admin or manager in Samurai App (the person who enables CloudSign)
  • A CloudSign account for each member who will use it from chat, with the same email address they use to sign in to Samurai App
  • CloudSign's document management permission for anyone who wants to list the team's documents

Steps

1. An admin enables CloudSign

Open the "Connectors" screen (/settings/connections), and from "Add API connection" on the "API" tab, choose CloudSign. Choose the environment ("Production" or "Sandbox"), enter your own client ID, and press "Enable CloudSign."

The client ID entered here is not saved. It is used only to check that the connection works and which team it belongs to. For the admin to use it from chat too, register your own client ID in the next step.

2. Each member registers their own client ID

  1. In the CloudSign admin screen, open "Client ID" and press "Issue a new client ID"
  2. Open CloudSign on Samurai App's "API" tab, paste it into the "Your client ID" field, and press "Register your client ID"
  3. When it shows "You will operate in CloudSign as XX," you are done

Registration works only when the email address of the CloudSign user for that client ID matches the email address signed in to Samurai App. Client IDs from other teams are not accepted either.

A client ID alone is enough to impersonate its owner. Do not use anyone else's, and do not paste it into the chat input either. CloudSign's official help also recommends issuing a separate client ID for each service you integrate.

3. Ask in chat

First, check which user you are acting as and what permissions you have.

In CloudSign, tell me which user I am operating as and what permissions I have

Next, ask for what you want to look up, together with the period.

List the documents signed this year and make a table of the counterparty, contract end date, cancellation notice deadline, and transaction amount for each.
Write "Not entered" for any blank document information field

When correcting document information, say which field of which document to change to what.

For the document in row 3 of that table, set the counterparty to "Sample Inc." and the management number to "2026-041"

By default, an approval card appears before the update. Check the document name and the fields being changed, then allow it.

Points to note

Check the accuracy of document information against the original contract. The chat reads the document information fields, not the text of the contract. When filling in blanks, open the PDF in the CloudSign screens and check it before asking for the update.

Listing the team's documents requires CloudSign's document management permission. Without it, only your own documents are covered. The first check tells you which permissions you have.

Some operations are not available on the Enterprise plan. CloudSign's official help states that on the Enterprise plan, the operation that returns information about yourself and your team (/me) and the list of all team documents (/team_documents) cannot be used. Samurai App checks who you are with /me at registration, so accounts for which this operation is refused cannot register, and the message "Accounts that use the multi-department management feature are not supported by this integration" is shown.

Deleting a client ID stops it from working in chat. As CloudSign's official help states, deleting a client ID that is in use also cuts off that integration. If you issue a new one, register it again in step 2. You can remove your own registration with "Delete client ID registration." When an admin disables CloudSign, the client IDs registered by all members are discarded. In this case too, the documents in CloudSign remain as they are.

Frequently asked questions

Can I send contracts from chat?

No. In the CloudSign Web API, the same call sends a document if it is a draft and sends a reminder if it is awaiting the other party, so mix-ups cannot be prevented in advance. Sending and reminders are done in the CloudSign screens.

Can the AI read the text of contracts?

Not with this integration. It can read the document information and up to the file names and page counts. If you want AI to read and search contract text and you use LegalOn for contract management, the integration described in How to search contracts from chat with the LegalOn API can read the text.

Can I try it in a sandbox?

When the admin enables it, they choose "Production" or "Sandbox" as the environment. It acts as the team in the selected environment.

Can I see other people's documents?

Only the documents you yourself can see in CloudSign. Listing the team's documents requires CloudSign's document management permission.

Sources

The two CloudSign Help Center pages above were checked as of November 9, 2026.

Related featureConnect business tools to AI over MCPSamurai App connects your business tools to AI over MCP. Operate accounting and HR SaaS from chat within each person's own permissions, call the agent from Slack or Teams, and use it from outside AI clients over MCP.

More automation examples

    Back to How-to articles

    Everyday work comes together, connects, and becomes the company's strength.

    Contact usOpen Samurai App

    See the demoContact us