> For the complete documentation index, see [llms.txt](https://nationgraph.gitbook.io/nationgraph/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nationgraph.gitbook.io/nationgraph/help-center/readme/automations-overview.md).

# Automations Overview

We’re introducing Automations a new powerful way to turn signals and public-sector data into structured workflows.

***

{% embed url="<https://screen.studio/share/pcSF4bcc?utm_medium=iframely&utm_source=gitbook>" %}
In-Depth intro about automations with our founder Kimia!
{% endembed %}

### What are Automations?

Automations turn NationGraph signals and public-sector data into repeatable workflows. They run in the background. They produce a structured results table you can export or sync!

NationGraph sends in-app notifications for supported automation completions and failures. If you subscribe to real-time email or Slack alerts, those notifications are also sent there.

Automations are best when you want **consistent outputs**. Signals are best when you want a **continuous inbox feed.**

### When to use Automations

* You need structured answers to the same questions across many institutions.
* You need contacts with specific titles across a territory.
* You need a ranked target list for a territory.
* You want a repeatable way to request and track vendor contracts.
* You want outputs that sync cleanly into Salesforce or HubSpot.

### Automation types

#### [Deep Research](/nationgraph/help-center/readme/compass/deep-research.md)

Save yourself from researching accounts one at a time. Select **Deep Research** when creating an Automation, then tell Compass what you need to learn. Compass will guide you through the questions, the accounts to include, and the cost before the research starts.

#### [Ranked Institutions](/nationgraph/help-center/readme/automations-overview/ranked-automations.md)

Create a prioritized list of institutions. Tune scoring using configurable criteria. Mix NationGraph scores with signals, population, and activity.

#### [Request Vendor/Competitor Contracts (FOIA)](/nationgraph/help-center/readme/automations-overview/foia-automations.md)

File FOIA requests automatically. Track responses and parsed contract records. Export clean contract data for downstream workflows.

#### [Email Automation](/nationgraph/help-center/readme/automations-overview/outreach-automations.md)

Target institutions effectively by leveraging signals like RFPs and meeting minutes. Improve communication with personalized messaging, call scripts, talking points, and automate sequences using templates.

#### [Find Contacts](/nationgraph/help-center/readme/automations-overview/contacts-automation.md)

Retrieve contacts from selected territories using required job titles and optional exclusion, similar-title, email, and phone filters.

### Key concepts

* **Scope**: Every automation run needs clear scope. This is usually territory, institution types, date range, and enabled data sources.
* **Runs**: Each time you run an automation, you create a new run.
* **Results**: Each run produces a results table.

{% hint style="info" %}
Selecting **Deep Research** from the new Automation menu opens **Compass**, your guide through the setup. After you start the report, find its progress and results under **Automations**.
{% endhint %}

### What you can do with results

* Review results in a structured table to get ranked insights
* Track run history and status updates.
* Export results as CSV.
* Sync results to your CRM.

### Quick Start

<table data-view="cards"><thead><tr><th>Guide</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td>Create a Deep Research report</td><td>Tell Compass what you need to learn, and it will guide you to a report you can use to prioritize accounts.</td><td><a href="/nationgraph/help-center/readme/compass/deep-research.md">Deep Research</a></td></tr><tr><td>Find contacts across a territory</td><td>Retrieve contacts using title, exclusion, email, and phone filters.</td><td><a href="/nationgraph/help-center/readme/automations-overview/contacts-automation.md">Find Contacts Automation</a></td></tr><tr><td>Create &#x26; run an automation</td><td>Set scope, run, review results, then export or sync.</td><td><a href="/nationgraph/help-center/readme/automations-overview/create-and-run-an-automation.md">Create &amp; run an automation</a></td></tr><tr><td>Rank institutions in a territory</td><td>Build a prioritized target list using configurable scoring.</td><td><a href="/nationgraph/help-center/readme/automations-overview/ranked-automations.md">Ranked Automations</a></td></tr><tr><td>Request vendor/competitor contracts (FOIA)</td><td>File FOIA requests automatically. Track responses. Export parsed contracts.</td><td><a href="/nationgraph/help-center/readme/automations-overview/foia-automations.md">FOIA Automations</a></td></tr><tr><td>Sync automation results to your CRM</td><td>Push tasks, notes, and mapped fields into Salesforce or HubSpot.</td><td><a href="/nationgraph/help-center/readme/automations-overview/sync-automation-results-to-your-crm.md">Sync automation results to your CRM</a></td></tr><tr><td>Browse all quick starts</td><td>The full library of guides across NationGraph.</td><td><a href="/nationgraph/help-center/readme/quick-starts.md">Quick starts</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://nationgraph.gitbook.io/nationgraph/help-center/readme/automations-overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
