NeonCRM uses API keys and the organization's Org ID to authenticate access to its API. How these credentials are used is different depending on the version of the NeonCRM API you are using.
An Org ID is the unique identifier for an organization's NeonCRM system.
To find your org ID, go to the Settings cog > Organization Profile
Locate the Account Information section and find Organization ID.
An API key is associated with a user in NeonCRM, and they inherit all the same permissions that their associated user has in the NeonCRM UI.
We recommend creating a new user for each integration you want to connect to NeonCRM, and limiting the permissions of that user to minimum required to perform the functions of the integration. This will make it easier to manage access to your NeonCRM and to deactivate an integration without affecting other apps connected to your system.
To obtain an API key, go to the Settings cog > User Management
Go to an existing user record or create a new user. On the user page, enable API Access and copy the API key.
User Sessions v1 only
The NeonCRM API v1 uses sessions to authenticate all requests, except the initial login request. You must request a
userSessionId by submitting your credentials to the login endpoint. You must then use the session ID for all subsequent requests to the API.
HTTP Basic Authentication v2 only
The NeonCRM API v2 uses the Basic HTTP authentication scheme for authenticating access to all API requests. Construct your request authorization header using your org ID and API key for the username and password respectively.
- Username: (Your org ID)
- Password: (Your API key)
API methods related to authentication.