Nimble CRM API
★ Only Publicly Available OpenAPI DocumentCRMContact Managementbearer, oauth241 EndpointsREST
For Agents
Create and update contacts, manage deals and pipelines, attach notes and files, and search linked messages on Nimble CRM across 41 endpoints under api.nimble.com/api/v1.
Use for: Create a new contact with email, phone, and company fields, Update the lifecycle stage of an existing Nimble contact, Batch-delete a list of contact IDs that bounced, Attach a discovery-call note to a contact
Not supported: Does not handle email sending, marketing automation, or telephony — use for Nimble CRM contact, deal, pipeline, note, and message operations only.
Jentic publishes the only available OpenAPI specification for Nimble CRM API, keeping it validated and agent-ready. Nimble is a CRM that consolidates contacts, deals, pipelines, messages, and notes alongside social and email signals so small teams can run a sales process from a single record. The API exposes 41 endpoints covering contact CRUD with batch deletes, custom contact fields and field groups, contact notes and tags, deals and deal pipelines with stats, deal notes and file attachments, message search across linked email and social channels, and the authenticated user's own profile. Auth is OAuth 2.0 authorisation code flow returning a bearer token.
Install Jentic One Beta
Connect the Nimble CRM API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nimble CRM API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Nimble CRM API.
Create, update, and batch-delete contact records through /contacts and /contact/{contact_id}
Define and group custom contact fields through /contact/fields and /contact/fields/group
Attach, edit, and remove contact notes through /contact/{contact_id}/notes
Tag contacts in bulk through PUT /contact/{contact_id}/tags
Track deals through pipeline stages with /deals, /deal/{deal_id}, and /deals/stats
Annotate deals with notes and file attachments through /deal/{deal_id} routes
Resolve the authenticated user via /myself for permission-aware actions
Use Cases
Patterns agents use Nimble CRM API for, with concrete tasks.
★ CRM contact sync from a marketing platform
When a contact is created in a marketing platform, an integration creates the corresponding Nimble record with full firmographic data. POST /contacts creates the record, PUT /contact/{contact_id} updates fields when the marketing record changes, and DELETE /contact/{contact_id} removes contacts that opted out. Custom fields defined through /contact/fields keep marketing attributes alongside Nimble's defaults.
POST a new contact to /contacts with first name, last name, primary email, and company, then PUT /contact/{contact_id} to add a custom 'lifecycle_stage' field value.
Deal pipeline reporting
Sales managers need a daily roll-up of open deals by stage and value. /deals returns deals filtered by pipeline and stage, /deals/stats returns aggregate counts and amounts, and /pipelines lists the current pipeline schema. Together they power a CRM dashboard without scraping the Nimble UI.
Call GET /deals/stats and post the open deal count and total amount to a #sales Slack channel each morning.
Activity logging from a meeting recorder
After a sales call, a meeting-recorder integration creates a contact note and attaches the recording. POST /contact/{contact_id}/notes adds the structured summary, and the matching deal-note endpoint can be used when the call relates to an open opportunity. PUT /contact/{contact_id}/notes/{note_id} edits the note as the human reviewer cleans up the summary.
POST a note to /contact/{contact_id}/notes with the meeting summary text and a reference to the recording URL.
Tag-based campaign segmentation
Marketers need to tag a cohort of contacts before launching a campaign. PUT /contact/{contact_id}/tags assigns one or more tags to a contact, and the agent can iterate over a list of contact IDs returned by GET /contacts/ids to scope the operation to the right segment.
GET /contacts/ids filtered by city=Dublin, then PUT /contact/{contact_id}/tags for each ID with the tag 'dublin-event-2026'.
AI agent CRM updates
An AI agent embedded in Slack or a sales workspace can create contacts, log notes, and update deals on Nimble without the user opening the CRM. Through Jentic, the agent searches for the right Nimble endpoint by intent and Jentic returns the schema with the OAuth bearer token attached server-side.
Search Jentic for 'create a contact in nimble', load POST /contacts, and execute it with name and email parsed from a chat message.
Key Endpoints
41 endpoints — jentic publishes the only available openapi specification for nimble crm api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/contacts
Create a new contact
GET
/contacts
List contacts with filters
PUT
/contact/{contact_id}
Update a contact
POST
/contact/{contact_id}/notes
Add a note to a contact
PUT
/contact/{contact_id}/tags
Assign tags to a contact
POST
/deals
Create a deal
GET
/deals/stats
Get aggregate deal stats
GET
/myself
Get the authenticated user profile
POST
/contacts
Create a new contact
GET
/contacts
List contacts with filters
PUT
/contact/{contact_id}
Update a contact
POST
/contact/{contact_id}/notes
Add a note to a contact
PUT
/contact/{contact_id}/tags
Assign tags to a contact
POST
/deals
Create a deal
GET
/deals/stats
Get aggregate deal stats
GET
/myself
Get the authenticated user profile
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Nimble OAuth bearer tokens are stored encrypted in the Jentic vault. Agents call Nimble via Jentic, which attaches Authorization: Bearer server-side; refresh tokens never enter the agent's chat context.
Intent-based discovery
Agents search Jentic by intent (e.g. 'create a contact' or 'log a call note') and Jentic returns the matching Nimble endpoint with its input schema.
Time to first call
Direct Nimble integration: 2-5 days for OAuth handshake, refresh-token rotation, and CRUD coverage. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Nimble CRM API through Jentic.
Why is there no official OpenAPI spec for Nimble CRM API?
Nimble does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Nimble CRM API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Nimble CRM API use?
Nimble uses OAuth 2.0 authorisation code flow; the resulting access token is sent as Authorization: Bearer <token> on every call. Through Jentic, the bearer token is held in the vault and attached server-side, so the agent never sees the raw token.
Can I batch-delete contacts in Nimble?
Yes. DELETE /contacts accepts a list of contact IDs in the request body and removes them in a single call, useful for cleaning out a list of bounced or unsubscribed contacts.
What are the rate limits for the Nimble CRM API?
Nimble enforces per-account rate limits but does not publish exact thresholds in this OpenAPI spec. If a script issues many writes in a short window expect HTTP 429; back off and retry.
How do I create a deal through Jentic?
Run pip install jentic, search Jentic for 'create a deal in nimble', and load POST /deals. Provide the pipeline ID, stage ID, contact ID, and amount fields, then execute. Jentic attaches the OAuth bearer token automatically.
Is the Nimble CRM API free?
API access is bundled with paid Nimble Business plans. There is no separate API fee, but a paid Nimble subscription is required.
GET STARTED