SourCherry Help Centre
HomeDocuments & ContractsDocuments and Contracts

Documents & Contracts: Public APIs

Automate document workflows in SourCherry with Documents & Contracts Public APIs. These APIs let developers list documents, send existing documents to contacts, retrieve templates, and generate documents from templates without manual work. This makes it easier to sync records, trigger document delivery from external systems, and streamline contract-related processes inside SourCherry. The feature is part of the broader Documents & Contracts experience in SourCherry and is designed for programmatic use.


TABLE OF CONTENTS



What is Documents & Contracts: Public APIs?


Documents & Contracts Public APIs give developers a way to work with document assets in SourCherry through API requests instead of manual actions in the app. They are useful when you need to connect SourCherry with external systems, automate sending from your own workflows, or dynamically create documents from saved templates. These APIs are scoped to the relevant SourCherry location and are best used when your process requires developer-led automation rather than a no-code workflow alone.


Documents & Contracts Public APIs currently support core document workflow actions such as:



Key Benefits of Documents & Contracts: Public APIs


Documents & Contracts Public APIs help teams reduce manual effort and connect document operations to the rest of their tech stack. They are especially valuable for businesses that want tighter control over when documents are generated, sent, and followed up on.



List Documents


Listing documents helps you retrieve available document records within a specific SourCherry location. This is useful for integrations that need to sync document inventories, display available items in another system, or verify which assets already exist before triggering additional actions.


You can use the List Documents endpoint to:


Send Document


Sending an existing document by API is helpful when a document has already been prepared in SourCherry and only needs to be delivered to the right contact at the right time. This supports custom business logic, external application triggers, and developer-driven automation beyond standard workflow actions.

You can use the Send Document endpoint to:


Keep in mind:


List Templates


Listing templates helps developers retrieve reusable document blueprints that are available in a SourCherry location. This is especially helpful when your external system needs to let users choose from approved templates without rebuilding the same content each time.


You can use the List Templates endpoint to:




Send Template


Sending a template lets you create and send a document from a saved template in one API call. This is one of the most useful options for automating proposals, agreements, and other repeatable document types because it combines document generation and delivery into a single action.

You can use the Send Template endpoint to:


This option is often best when:

Suggested screenshot: Template selection or template editor view in SourCherry, showing the reusable structure the API can generate from.


How To Setup Documents & Contracts Public APIs


A proper setup ensures your integration can authenticate securely, use the right SourCherry location, and call the correct API endpoints. Before building, make sure you understand whether your use case is better served by a Private Integration or a broader developer implementation supported through the SourCherry API platform.


  1. Confirm that Documents & Contracts is part of your workflow and that the needed documents or templates already exist in the correct SourCherry location.

  2. Review the current SourCherry API Documentation to confirm endpoint behavior, authentication requirements, and request details. SourCherry’s official API documentation is now hosted through the Developer Marketplace documentation path.

  3. Decide on the correct authentication method for your integration. Private Integrations are intended for secure internal connections, while Marketplace-style developer flows may use OAuth-based access.

  4. Make sure your API requests are targeting the correct SourCherry location context so that documents and templates are retrieved from the intended account area.

  5. Test your request flow for the specific action you need:

    • List Documents

    • Send Document

    • List Templates

    • Send Template

  6. If you want actions after a send, connect your process to workflow automations that respond to document events such as sent, viewed, signed, or completed.


Frequently Asked Questions


Q: Are Documents & Contracts Public APIs meant for developers?
Yes. The feature is designed for programmatic use, especially for teams building integrations, automations, or custom applications around SourCherry document workflows.


Q: What is the difference between Send Document and Send Template?
Send Document sends an existing document that is already in SourCherry. Send Template creates a new document from a template and sends it in the same request.


Q: Can I use these APIs instead of workflows?
Yes, when your process starts outside SourCherry or needs custom logic. Workflows are often better for no-code automation inside SourCherry, while APIs are better for developer-led integrations.


Q: Do these APIs work with templates already created in SourCherry?
Yes. The template-related endpoints are designed to retrieve templates in a location and create documents from them programmatically.


Q: Can I automate follow-ups after a document is sent?
Yes. You can pair API-based sends with Documents & Contracts workflow triggers to automate reminders, internal notifications, or downstream actions based on document status.


Q: Do I need Private Integrations to use these APIs?
Not always. Private Integrations are one option for secure internal use cases, but SourCherry also supports broader developer access patterns through its current API platform and Marketplace documentation.


Q: What does “location” mean for these endpoints?
These endpoints operate within the relevant SourCherry location context, so documents and templates returned by the API are tied to that location’s data.


Q: Can I manage every document action through these public APIs?
The feature article specifically documents listing and sending actions for documents and templates. For the most current endpoint coverage, always confirm the official API documentation.