# Nous ## Docs - [Changelog](https://docs.opennous.cloud/changelog/overview.md): New features, improvements, and fixes shipped in Nous. - [Contributing](https://docs.opennous.cloud/contributing/introduction.md): How to get started developing and contributing to Nous - [Developer App (oAuth2)](https://docs.opennous.cloud/developer-app/introduction.md): Build apps on top using oAuth2 - [How it works](https://docs.opennous.cloud/getting-started/how-it-works.md): The Nous architecture. Ingestion, identity resolution, and how every signal becomes part of the customer graph. - [Introduction](https://docs.opennous.cloud/getting-started/introduction.md): Welcome to Nous documentation - [Quickstart](https://docs.opennous.cloud/getting-started/quickstart.md): Get Nous running locally and connect your first integration in under 15 minutes - [Development Environment](https://docs.opennous.cloud/installation/development-environment.md): Run Nous locally for development - [Docker Compose](https://docs.opennous.cloud/installation/docker-compose.md): Deploy Nous on your own server with Docker Compose - [MCP Server](https://docs.opennous.cloud/mcp/introduction.md): @opennous/mcp — give Claude Code, Codex, Cursor, and any MCP-compatible client one call into the Nous Account Record. - [attention](https://docs.opennous.cloud/mcp/tools/attention.md): What needs your attention across the workspace right now — accounts gone quiet, key facts decayed. Each item ships with a suggested action. - [get_account](https://docs.opennous.cloud/mcp/tools/get-account.md): The full Account Record — every known fact with its confidence and freshness, plus the recent activity timeline. - [get_context](https://docs.opennous.cloud/mcp/tools/get-context.md): Engineered context for one task about one entity. The headline call before drafting outreach, prepping a meeting, or making any decision about a person or company. - [get_gtm_profile](https://docs.opennous.cloud/mcp/tools/get-gtm-profile.md): The user's own GTM profile — ICP, market, product, pricing, competitors, positioning. Workspace-level, NOT per-entity. - [query](https://docs.opennous.cloud/mcp/tools/query.md): Retrieve and summarise a corpus of activity across many people. The graph retrieves; your agent finds the pattern. - [record](https://docs.opennous.cloud/mcp/tools/record.md): Record what happened or what you learned. You observe — Nous derives the updated facts. The only write verb. - [save_note](https://docs.opennous.cloud/mcp/tools/save-note.md): Keep a meeting brief, transcript, prep, or plain note on a contact's record — append-only and dated, so a contact builds a history across meetings. - [search_notes](https://docs.opennous.cloud/mcp/tools/search-notes.md): Semantic search over the saved notes & documents kept on contacts — pull the relevant passage instead of dumping whole documents into context. - [update_gtm_profile](https://docs.opennous.cloud/mcp/tools/update-gtm-profile.md): Write back a lasting change to a section of the user's own GTM context — the section evolves and the prior version is kept as history, never silently contradicted. - [verify](https://docs.opennous.cloud/mcp/tools/verify.md): Re-check a specific fact before you act on it. The calibration check. - [Add a new provider](https://docs.opennous.cloud/providers/add-new-provider.md): How to connect a new integration to your workspace - [Apollo](https://docs.opennous.cloud/providers/apollo.md): Connect Apollo as your enrichment source and optionally sync sequences as activity signals. - [Attio](https://docs.opennous.cloud/providers/attio.md): Connect Attio to sync contacts and records into Nous. - [Cal.com](https://docs.opennous.cloud/providers/cal-com.md): Log meeting bookings, cancellations, and reschedules on contact timelines when someone schedules with you on Cal.com. - [Calendly](https://docs.opennous.cloud/providers/calendly.md): Log meeting bookings and cancellations on contact timelines when someone schedules with you. - [EmailBison](https://docs.opennous.cloud/providers/emailbison.md): Log email outbound events from EmailBison on contact timelines. - [Fathom](https://docs.opennous.cloud/providers/fathom.md): Log meeting recordings and summaries on contact timelines. - [Fireflies.ai](https://docs.opennous.cloud/providers/fireflies.md): Pull meeting transcripts and summaries into contact timelines. - [Gmail & Google Calendar](https://docs.opennous.cloud/providers/gmail.md): Sync emails and calendar events automatically via Google OAuth. - [Google Calendar](https://docs.opennous.cloud/providers/google-calendar.md): Log meetings from Google Calendar as activity signals on your contacts. - [HeyReach](https://docs.opennous.cloud/providers/heyreach.md): Log LinkedIn outbound events from HeyReach on contact timelines. - [HubSpot](https://docs.opennous.cloud/providers/hubspot.md): Connect HubSpot to sync contacts and deals into Nous. - [Instantly](https://docs.opennous.cloud/providers/instantly.md): Log email sequence events from Instantly.ai on contact timelines. - [LinkedIn](https://docs.opennous.cloud/providers/linkedin.md): Log connection requests, messages, and profile visits via Unipile. - [Providers](https://docs.opennous.cloud/providers/overview.md): Connect your GTM stack to Nous - [Pipedrive](https://docs.opennous.cloud/providers/pipedrive.md): Connect Pipedrive to sync contacts and deals into Nous. - [Prospeo](https://docs.opennous.cloud/providers/prospeo.md): Nous's default enrichment provider — looks up email, phone, LinkedIn, and company data for your contacts. - [RB2B](https://docs.opennous.cloud/providers/rb2b.md): De-anonymise website visitors and match them to contacts - [Slack](https://docs.opennous.cloud/providers/slack.md): Pull DMs and channel messages into contact timelines automatically. - [Smartlead](https://docs.opennous.cloud/providers/smartlead.md): Log email outbound events from Smartlead on contact timelines. - [Custom SMTP / IMAP](https://docs.opennous.cloud/providers/smtp.md): Connect your own email server to sync sent and received emails as activity signals. - [Get Account](https://docs.opennous.cloud/public-api/accounts.md): The full Account Record — entity + every claim with epistemics + recent observation timeline. - [Attention](https://docs.opennous.cloud/public-api/attention.md): Workspace-wide: accounts gone quiet, key facts decayed. Ranked decisions, each with a suggested action. - [Get Context](https://docs.opennous.cloud/public-api/context.md): Engineered context for one task about one entity. The ranked, claim-tagged block your agent consumes before acting. - [Dedup](https://docs.opennous.cloud/public-api/dedup.md): Cross-list cold-outbound dedup. Classify identifiers as net_new / engaged / bounced / unsubscribed BEFORE you spend. - [GTM Profile](https://docs.opennous.cloud/public-api/gtm-profile.md): The user's own GTM profile — ICP, target market, product, pricing, competitors. Workspace-level, not per-entity. - [REST API](https://docs.opennous.cloud/public-api/introduction.md): The deterministic surface for workflow runtimes. Call it from n8n, Make, Zapier, or any backend. Parameters are known up front; responses are stable rows. - [Bulk Create Leads](https://docs.opennous.cloud/public-api/leads/bulk.md): Add up to 1000 leads to a list in a single call. Same dedup behaviour as single create. - [Create Lead](https://docs.opennous.cloud/public-api/leads/create.md): Add a single row to a lead list. Workspace-wide dedup on email and normalised LinkedIn URL is on by default. - [List Leads](https://docs.opennous.cloud/public-api/leads/list.md): Filtered, paginated list of leads across all lead lists in the workspace. - [Update Lead](https://docs.opennous.cloud/public-api/leads/update.md): Patch a lead row mid-workflow. The morning-loop fix — record sent_at the instant you fire the email so the next iteration's filter excludes the row. - [Save a Note](https://docs.opennous.cloud/public-api/notes.md): Attach a meeting brief, transcript, prep, or plain note to a contact's record. Append-only and dated, so a contact builds a history across meetings. - [Search Notes](https://docs.opennous.cloud/public-api/notes-search.md): Semantic search over the saved notes & documents kept on contacts. Pull the relevant passage instead of loading whole documents. - [Record Observations](https://docs.opennous.cloud/public-api/observations.md): Record what happened. You observe; Nous derives the claims. - [Create Person](https://docs.opennous.cloud/public-api/people/create.md): Create or upsert a person by identifier. Idempotent — if an entity with one of the identifiers already exists, you get it back with any new claim values asserted onto it. - [List People](https://docs.opennous.cloud/public-api/people/list.md): Filtered, paginated list of people in the workspace. Workflow shape — same projection your agent sees through /v2/accounts/:id. - [Update Person](https://docs.opennous.cloud/public-api/people/update.md): Assert claim values directly on a person. Asserted claims are sticky — the derivation engine will not overwrite them from later observations. - [Query](https://docs.opennous.cloud/public-api/query.md): Retrieve + summarise observations across many entities. Three powers — group by entity, subtract a set, roll up by value — answer 'hottest leads', 'no reply in 5d', 'funnel by stage' without new endpoints. - [Events Reference](https://docs.opennous.cloud/public-api/triggers/events.md): Every event you can subscribe to, with a sample payload. - [Triggers](https://docs.opennous.cloud/public-api/triggers/introduction.md): Outbound webhooks. Nous POSTs to your URL the moment a tracked interaction happens, so your workflow runs without polling and without a webhook subscription on the upstream tool. - [Verify](https://docs.opennous.cloud/public-api/verify.md): Re-check one claim against current observations. The calibration check before any high-stakes action. - [Cal.com Webhook](https://docs.opennous.cloud/webhooks/cal-com.md): Log meeting bookings, cancellations, and reschedules from Cal.com on contact timelines. - [Calendly Webhook](https://docs.opennous.cloud/webhooks/calendly.md): Log meeting bookings and cancellations from Calendly on contact timelines. - [Custom Capture](https://docs.opennous.cloud/webhooks/custom.md): Log any signal from any source using the authenticated capture API. - [EmailBison Webhook](https://docs.opennous.cloud/webhooks/emailbison.md): Log email outbound events from EmailBison on contact timelines. - [Fathom Webhook](https://docs.opennous.cloud/webhooks/fathom.md): Log meeting recordings from Fathom on contact timelines. - [Fireflies Webhook](https://docs.opennous.cloud/webhooks/fireflies.md): Log meeting transcripts from Fireflies.ai on contact timelines. - [HeyReach Webhook](https://docs.opennous.cloud/webhooks/heyreach.md): Log LinkedIn outbound events from HeyReach on contact timelines. - [Instantly Webhook](https://docs.opennous.cloud/webhooks/instantly.md): Log email sequence events from Instantly.ai on contact timelines. - [Webhook Overview](https://docs.opennous.cloud/webhooks/overview.md): Every inbound webhook endpoint Nous exposes — URLs, payloads, and HMAC secrets. - [RB2B Webhook](https://docs.opennous.cloud/webhooks/rb2b.md): De-anonymize website visitors and log them as contacts with a website_visit activity. - [Smartlead Webhook](https://docs.opennous.cloud/webhooks/smartlead.md): Log email outbound events from Smartlead on contact timelines. ## OpenAPI Specs - [openapi](https://docs.opennous.cloud/openapi.json) ## Optional - [GitHub](https://github.com/NousC/nous) - [Discord](https://discord.gg/2Ph4ZYXw)