Nutshell

Syncs every lead, deal, and activity into your automation layer and triggers follow up sequences based on pipeline stage changes.

Try Nutshell in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Nutshell integration

    • Describe the outcome and Ceven picks the right Nutshell calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Nutshell data, across all 78 of its actions.
  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Nutshell access.
    • Per user and per environment credentials instead of shared keys.
  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Nutshell, when, and on whose behalf.
    • The agent pauses and asks when Nutshell is unclear instead of plowing ahead.
  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Nutshell.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Nutshell action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Nutshell, and when to use it.

Create lead
Use this when a new prospect arrives from a web form or external list to start a new record in the CRM.
Update deal stage
Move a deal to a different pipeline phase. Use this to trigger automation when a prospect moves from discovery to proposal.
Get contact details
Pull the full contact profile including email, phone, and custom fields for a specific person.
Add note to record
Append a text note to a contact or deal. Use this to log summaries of phone calls or meeting minutes.
Search contacts
Find people or companies by name, email, or custom tag to avoid creating duplicate records.
List active deals
Pull all deals currently in the pipeline filtered by stage or owner for reporting purposes.
Create activity
Schedule a call, task, or meeting for a user and link it to a specific contact or deal.
Update contact
Change specific fields on a contact record like job title, company, or lead source.
Get deal info
Pull all metadata for a specific deal including value, expected close date, and current stage.
Create company
Create a new organization record to group multiple contacts under one corporate entity.
Link contact to company
Associate an existing person with an existing company record to maintain clean data relationships.
Delete lead
Remove a contact record from the system. Use this for cleanup or GDPR compliance requests.

12 actions · scroll to see them all

Frequently asked questions

Ceven uses a search first approach to prevent data clutter. Before the agent creates a new lead or contact, it runs a search query against your Nutshell database using the email address as the primary key. If a match is found, the agent asks if you want to update the existing record or create a duplicate. You can also configure custom matching rules in the workflow settings, such as matching by company name and last name. This ensures your pipeline remains clean and you do not have multiple records for the same prospect, which prevents fragmented communication histories and conflicting deal stages across your sales team.
Yes. While Nutshell handles the delivery of the emails, Ceven manages the logic that triggers them. You can build a workflow where a specific event, such as a lead reaching a certain score or a deal moving to a specific stage, signals Ceven to add that contact to a particular Nutshell mailing list. The agent can also monitor for replies to those emails and automatically update the deal stage or create a high priority task for a sales rep to jump in. This creates a closed loop where your marketing outreach and sales follow up are perfectly synchronized without manual list management.
Nutshell employs a rate limiting system to ensure platform stability. If your workflow triggers a massive bulk update, such as importing thousands of leads at once, you might hit these limits. Ceven manages this by implementing an exponential backoff strategy. This means if the agent receives a rate limit error from Nutshell, it will automatically pause and retry the request after a short delay. For most users, this happens invisibly in the background. However, if you are running extremely high volume migrations, we recommend staggering your workflow triggers to avoid hitting the hard ceiling of the Nutshell API tier.
Ceven has full visibility into your custom fields. When you connect your account, the agent maps your unique schema so you can use those fields in your prompts and workflows. For example, if you have a custom field for property type or budget range, you can tell the agent to filter deals based on those specific values. This allows the agent to perform complex segmentation and routing that goes beyond the standard lead and deal fields. Any changes you make to your custom fields in the Nutshell settings will be reflected in the agent context after a brief synchronization period.
Absolutely. You can set up a migration workflow where Ceven reads data from your old CRM and maps it into the corresponding fields in Nutshell. The agent is particularly useful here because it can clean the data during the transition. For instance, it can format phone numbers to a standard layout, capitalize names correctly, or categorize leads based on keywords in their description before they ever hit your new Nutshell database. This ensures that you start with a high data quality environment rather than just importing a messy spreadsheet of old contacts.
Ceven can monitor and manage ownership transfers within Nutshell. You can create a workflow that automatically reassigns leads based on a round robin logic or specific territory rules. When a deal owner is changed, the agent can simultaneously notify the new owner via Slack or email and create a series of onboarding tasks to ensure the new rep is up to speed. It can also log the transfer in the deal notes so there is a clear audit trail of who owned the account at each stage of the sales cycle.
Security is built into the core of the integration. Ceven uses secure token based authentication to interact with the Nutshell API. We never store your raw login credentials. All data transmitted between Nutshell and Ceven is encrypted using industry standard protocols. Furthermore, the agent only accesses the specific data points required to execute the workflow you have designed. We do not scrape your entire database for training purposes. You have full control over the permissions and can disconnect the integration at any time from your dashboard, which immediately kills all active access tokens.
Yes. The agent understands the relational structure of Nutshell. It can create a company record and then link multiple contacts to that company, or it can find an existing company and add a new contact to it. This is useful for B2B sales where you are dealing with multiple stakeholders at a single organization. You can tell the agent to find everyone associated with a specific company and send a summary of the account status to your manager. The agent manages the underlying IDs to ensure the links are created correctly without you needing to handle the technical mapping.

Alternatives to Nutshell

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Nutshell and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free