Nutshell · Authentication Profile

Nutshell Authentication

Authentication

Nutshell secures its APIs with http and oauth2 across 2 declared security schemes, as derived from its OpenAPI definitions.

CRMSalesPipeline ManagementEmail MarketingContact ManagementSales AutomationLead ManagementMarketing AutomationMCPB2B
Methods: http, oauth2 Schemes: 2 OAuth flows: API key in:

Security Schemes

basicAuth http
scheme: basic
oauth2 oauth2

Source

Authentication Profile

Raw ↑ 
generated: '2026-08-13'
method: searched
source: https://developers.nutshell.com/docs/api-authentication
docs: https://developers.nutshell.com/docs/api-authentication
summary:
  types:
  - http
  - oauth2
  note: 'Two distinct auth models on one estate. Every data API — REST, GraphQL and JSON-RPC — uses HTTP Basic with
    a user email and an account API key, and all of them are HTTPS-only under app.nutshell.com. The MCP server is
    the exception: it uses OAuth 2.0 authorization code + PKCE with dynamic client registration. There is no bearer-token
    or OIDC option for the data APIs.'
schemes:
- name: basicAuth
  type: http
  scheme: basic
  applies_to:
  - nutshell:rest-api
  - nutshell:graphql
  - nutshell:json-rpc
  description: HTTP Basic. Username is a Nutshell user's email address; password is an API key created in Setup
    > API keys (https://app.nutshell.com/setup/api-key). The key inherits a permission type chosen at creation.
    Nutshell warns to treat the key like a password.
  key_issuance: https://app.nutshell.com/setup/api-key
  transport: HTTPS only, app.nutshell.com
  sources:
  - https://developers.nutshell.com/docs/api-authentication
  - openapi/_original/nutshell-api.json
- name: oauth2
  type: oauth2
  flow: authorization_code
  pkce: S256
  applies_to:
  - nutshell mcp
  description: OAuth 2.0 for the Nutshell MCP server. The user signs in to Nutshell and approves a consent page;
    the client registers dynamically at /oauth/register. Scopes read and write.
  scopes:
  - read
  - write
  endpoints:
    authorization: https://app.nutshell.com/oauth/authorize
    token: https://app.nutshell.com/oauth/token
    registration: https://app.nutshell.com/oauth/register
    revocation: https://app.nutshell.com/oauth/revoke
  sources:
  - well-known/nutshell-oauth-authorization-server.json
  - https://support.nutshell.com/en/articles/12631143-mcp-server
gaps:
- No OIDC discovery document (/.well-known/openid-configuration is 404 on every host).
- No published permission/scope matrix for API keys.
- No bearer-token option and no key rotation policy published.

Work with this as data

Every security artifact here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for security posture

4 MCP tools reach this
  • find_securityBrowse and filter every security artifact in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This security artifact 
curl "https://apis.io/api/v1/security/nutshell-authentication"
All security posture 
curl "https://apis.io/api/v1/security?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.