Nexus CRM
Nexus CRM runs fixed flow steps on the Nexus CRM: search for a contact, read their full record, look up a salesperson’s deals, log a call, add a note or a follow-up task, or propose a new deal. With a single component you work with contacts, company accounts, deals and activities.
The component works as the person who signed in on the credential: it only sees what that person sees in Nexus (a salesperson, their own deals) and whatever it records is in their name.
When to use it
- After a meeting, an agent summarises the transcript and you want to log the interaction and the next step in Nexus.
- Every morning you want to send a salesperson the summary of their open deals.
- When a customer’s email arrives, you want to add a note to their record or create a follow-up task.
- You want to propose a new deal from an automation and have a salesperson approve it.
Configuration
You need an MCP Remote server credential connected to Nexus’s MCP server with your sign-in. See Credentials and Use MCP servers.
- Create an MCP Remote server credential.
- In MCP Server url type your Nexus address followed by
/api/v1/mcp, for examplehttps://nexus.your-company.com/api/v1/mcp. - In MCP Server auth choose
OAuth2.1and click the sign-in button. - Sign in to Nexus with your account. Nexus asks you what NappAI can do: Read only or Read and work. To log notes, interactions, tasks or deals, choose Read and work, and click Authorize.
| Field | What it does |
|---|---|
| Credential (required) | The MCP Remote server credential with your Nexus sign-in. |
| MCP server URL | Filled in by the credential: the Nexus address or its MCP server address (the one ending in /api/v1/mcp). |
| Resource | What you work with: Contacts, Accounts, Deals or Activities. Default: Contacts. |
| Operation | What you do. The list changes with the chosen Resource. See Resources and operations. |
IDs are the numbers Nexus uses, for example 1532. #1532 is accepted too.
Resources and operations
Contacts
| Operation | What it does | Fields |
|---|---|---|
Search Contacts | Searches contacts by name, email or company. | Optional: Search and Limit (default 20, at most 500). |
Get Contact | Returns a contact’s full record (their 360 view). | Contact ID |
Contact Timeline | Returns a contact’s history: interactions, notes, tasks and deals. | Contact ID |
Accounts (company accounts)
| Operation | What it does | Fields |
|---|---|---|
Get Account | Returns a company account’s full record. | Account ID |
Deals
| Operation | What it does | Fields |
|---|---|---|
List My Deals | Returns the deals of the person who signed in. | Optional: Status (Any, OPEN, WON or LOST), Search (text in the title), Stage ID and Limit (default 20, at most 50). |
Get Deal | Returns one deal. | Deal ID. Optional: With activities, to also return its activities and next steps. |
Pipeline Summary | Returns the sales pipeline’s stages with their ID and their totals. | |
Create Deal | Proposes a new deal for a contact. | Title, Contact ID. Optional: Amount, Expected close and Stage ID. |
Update Deal | Proposes changing a deal’s title, amount or expected close date. | Deal ID and at least one of Title, Amount or Expected close. |
Move Deal Stage | Proposes moving a deal to another open stage. | Deal ID, Stage ID |
- Amount is the amount in the company’s currency, for example
1500.1.500,50or1,500.50are understood too. - Expected close is a date such as
2026-12-15. - Stage ID is the ID of an open stage.
Pipeline Summaryreturns it.
Activities
| Operation | What it does | Fields |
|---|---|---|
Add Note | Adds a note to a contact. | Contact ID, Note (up to 20,000 characters). |
Log Interaction | Logs a call, a meeting or a demo with a contact, and its outcome. | Contact ID, Summary and outcome. Optional: Type and When. |
Add Task | Creates a follow-up task for a contact. | Contact ID, Title. Optional: Kind, Details, Deal ID and Due. |
Add Next Step | Adds a next step to a deal. | Deal ID, Title. Optional: Type, Details and Due. |
- In
Log Interaction, Type can beCALL(default),MEETING,DEMO,PRESENTATION,EMAILorOTHER. When is the date and time it happened. - In
Add Task, Kind can beOTHER(default),CALL,EMAIL,LINKEDINorMEETING. Deal ID links the task to a deal. - In
Add Next Step, Type can beTASK(default),CALL,MEETING,EMAILorNOTE. - Due is the due date and time, for example
2026-11-20T10:00:00Z.
Output
The Data output returns Nexus’s answer as data: one item per contact or deal in searches and lists, and the record, the confirmation or the change proposal in the others.
The component can be connected to an Agent as a tool for a specific action. See Tools. If you want an agent to use the whole CRM, use Nexus MCP.
Example
A sales team wants every meeting logged in Nexus without typing it by hand.
- The flow receives the meeting transcript and an agent summarises it, with the customer’s email and what was agreed.
- Add Nexus CRM with the
Contactsresource and theSearch Contactsoperation, with the customer’s email in Search. - Connect a second Nexus CRM with the
Activitiesresource and theLog Interactionoperation: in Contact ID theidof the contact found,MEETINGin Type and the summary in Summary and outcome. - If a next step was agreed in the meeting, add
Add Taskwith the title and the due date.
Good practices
- Search first and pass the numeric ID: operations don’t accept names instead of IDs.
- Use the right person’s credential: the flow will see and record what that person would see and record.
- If the connection with Nexus stops working, edit the credential and click Revalidate to sign in again.
Security and limitations
- Nexus doesn’t allow closing deals (winning or losing them) from outside:
Move Deal Stageonly moves to open stages. - Creating, editing or moving a deal always needs a person’s approval in Nexus, within 10 minutes.
- If you chose Read only when signing in, the operations that record something fail. Sign in again with Read and work.
- You can withdraw NappAI’s access in Nexus, under My profile › Connections › AI assistants.
Related components
- Nexus MCP: all the CRM’s tools for an agent.
- Nexus Intake: send leads from forms, without signing in.
- Nexus Webhook: starts the flow with what happens in Nexus.