API Documentation

This page is intended for software developers wishing to integrate their applications with NetHunt CRM. We support listing folders, creating, searching and updating records via our API.

Interaction with NetHunt CRM happens via HTTPS using GET and POST methods and the "application/json" media type for payload. All URLs in this documentation are relative to "https://nethunt.com/api/v1/zapier". For access control the "Basic" HTTP authentication scheme is employed, where an email address is used in place of the user name and a special API key in place of the password. In order to obtain the API key log into your Gmail account with NetHunt enabled and find the API key under the NetHunt CRM tab in Settings (click on "Generate" if necessary).

Operations

List all accessible folders

GET /triggers/readable-folder
Sample request
GET https://nethunt.com/api/v1/zapier/triggers/readable-folder
Sample result
[
    {
        "id": "596f644b8f6d05e16c24b810",
        "name": "My first folder"
    },
    {
        "id": "596f644b8f6d05e16c24b811",
        "name": "My second folder"
    }
]
                
Result fieldsDescription
idFolder ID
nameFolder name

List folders which the user can create records in

GET /triggers/writable-folder
Sample request
GET https://nethunt.com/api/v1/zapier/triggers/writable-folder
Sample result
[
    {
        "id": "596f644b8f6d05e16c24b810",
        "name": "My first folder"
    },
    {
        "id": "596f644b8f6d05e16c24b811",
        "name": "My second folder"
    }
]
                
Result fieldsDescription
idFolder ID
nameFolder name

List folder fields

GET /triggers/folder-field/{folderId}
Sample request
GET https://nethunt.com/api/v1/zapier/triggers/folder-field/596f710ef5be7653dee0da14
Request parameterDescriptionDefault value
folderIdFolder ID to list fieldsRequired
Sample result
[
    {
        "name": "Name"
    },
    {
        "name": "Birthday"
    },
    {
        "name": "Primary Email Address"
    }
]
                
Result fieldsDescription
nameFolder field name

Find records by ID or text query

GET /searches/find-record/{folderId}?recordId={recordId}&query={query}&limit={limit}
Sample request
GET https://nethunt.com/api/v1/zapier/searches/find-record/596f710ef5be7653dee0da14?query=Name%3ADoe&limit=10
Request parameterDescriptionDefault value
folderIdFolder ID to find records inRequired
recordIdRecord ID if availableEither recordId or query must be specified
querySearch queryto narrow records returnedEither recordId or query must be specified
limitMaximum number of records to return1
Sample result
[
    {
        "id": "596f644b8f6d05e16c24b830",
        "recordId": "596f644b8f6d05e16c24b830",
        "createdAt": "2015-01-01T12:34:15.880Z",
        "updatedAt": "2015-02-01T12:30:10.510Z",
        "fields": {
            "Name": "John Doe",
            "Birthday": "1980-01-01",
            "Employed": true,
            "Salary": 100000,
            "Keywords": [
                "Java",
                "Big Data"
            ],
            "Primary Email Address": "John Doe <john.doe@example.com>",
            "Other Email Addresses": [
                "J. Doe <j.doe@example.com>",
                "J. D. <j.d@example.com>"
            ],
            "Co-workers": [
                "596f64368f6d05e16c24b833",
                "596f644b8f6d05e16c24b834"
            ]
        }
    },
    {
        "id": "596f644b8f6d05e16c24b831",
        "recordId": "596f644b8f6d05e16c24b831",
        "createdAt": "2015-02-01T12:35:15.880Z",
        "fields": {
            "Name": "Jane Doe"
        }
    }
]
                
Result fieldsDescription
idFor internal purposes only
recordIdRecord ID
createdAtTime of record creation
updatedAtTime of last record update
fieldsField names and values

Find recently created records

GET /triggers/new-record/{folderId}?since={since}&limit={limit}
Sample request
GET https://nethunt.com/api/v1/zapier/triggers/new-record/596f710ef5be7653dee0da14?since=2015-01-01T00%3A00%3A00.000Z&limit=2
Request parameterDescriptionDefault value
folderIdFolder ID to find new records inRequired
sinceOnly records created after this time are returned24 hours before time of request
limitMaximum number of records to returnNo limit
Sample result
[
    {
        "id": "596f644b8f6d05e16c24b830",
        "recordId": "596f644b8f6d05e16c24b830",
        "createdAt": "2015-01-01T12:34:15.880Z",
        "fields": {
            "Name": "John Doe",
            "Birthday": "1980-01-01",
            "Employed": true,
            "Salary": 100000,
            "Keywords": [
                "Java",
                "Big Data"
            ],
            "Primary Email Address": "John Doe <john.doe@example.com>",
            "Other Email Addresses": [
                "J. Doe <j.doe@example.com>",
                "J. D. <j.d@example.com>"
            ],
            "Co-workers": [
                "596f64368f6d05e16c24b833",
                "596f644b8f6d05e16c24b834"
            ]
        }
    },
    {
        "id": "596f644b8f6d05e16c24b831",
        "recordId": "596f644b8f6d05e16c24b831",
        "createdAt": "2015-02-01T12:35:15.880Z",
        "fields": {
            "Name": "Jane Doe"
        }
    }
]
                
Result fieldsDescription
idFor internal purposes only
recordIdRecord ID
createdAtTime of record creation
fieldsField names and values

Find recently created record comments

GET /triggers/new-comment/{folderId}?since={since}&limit={limit}
Sample request
GET https://nethunt.com/api/v1/zapier/triggers/new-comment/596f710ef5be7653dee0da14?since=2015-01-01T00%3A00%3A00.000Z&limit=2
Request parameterDescriptionDefault value
folderIdFolder ID to find new record comments inRequired
sinceOnly record comments created after this time are returned24 hours before time of request
limitMaximum number of record comments to returnNo limit
Sample result
[
    {
        "id": "596f644b8f6d05e16c24b820",
        "commentId": "596f644b8f6d05e16c24b820",
        "recordId": "596f644b8f6d05e16c24b830",
        "createdAt": "2015-01-01T12:34:15.880Z",
        "text": "My first comment"
    },
    {
        "id": "596f644b8f6d05e16c24b821",
        "commentId": "596f644b8f6d05e16c24b821",
        "recordId": "596f644b8f6d05e16c24b831",
        "createdAt": "2015-01-01T14:34:15.880Z",
        "text": "My second comment"
    }
]
                
Result fieldsDescription
idFor internal purposes only
commentIdComment ID
recordIdRecord ID
createdAtTime of comment creation
textComment text

Find recently updated records

GET /triggers/updated-record/{folderId}?fieldName={fieldName}&since={since}&limit={limit}
Sample request
GET https://nethunt.com/api/v1/zapier/triggers/updated-record/596f710ef5be7653dee0da14?fieldName=Primary%20Email%20Address&fieldName=Other%20Email%20Addresses&since=2015-01-01T00%3A00%3A00.000Z&limit=1
Request parameterDescriptionDefault value
folderIdFolder ID to find updated records inRequired
fieldNameField name to limit updates observedOptional, multiple parameters with the same name allowed
sinceOnly records updated after this time are returned24 hours before time of request
limitMaximum number of records to returnNo limit
Sample result
[
    {
        "id": "596f644b8f6d05e16c24b830-1500113235379",
        "recordId": "596f644b8f6d05e16c24b830",
        "createdAt": "2015-01-01T12:34:15.880Z",
        "updatedAt": "2015-02-01T12:30:10.510Z",
        "fields": {
            "Name": "John Doe",
            "Birthday": "1980-01-01",
            "Employed": true,
            "Salary": 100000,
            "Keywords": [
                "Java",
                "Big Data"
            ],
            "Primary Email Address": "John Doe <john.doe@example.com>",
            "Other Email Addresses": [
                "J. Doe <j.doe@example.com>",
                "J. D. <j.d@example.com>"
            ],
            "Co-workers": [
                "596f64368f6d05e16c24b833",
                "596f644b8f6d05e16c24b834"
            ]
        }
    },
    {
        "id": "596f644b8f6d05e16c24b831",
        "recordId": "596f644b8f6d05e16c24b831",
        "createdAt": "2015-02-01T12:35:15.880Z",
        "fields": {
            "Name": "Jane Doe"
        }
    }
]
                
Result fieldsDescription
idFor internal purposes only
recordIdRecord ID
createdAtTime of record creation
updatedAtTime of last record update
fieldsField names and values

Find recent record changes

GET /triggers/record-change/{folderId}?recordId={recordId}&fieldName={fieldName}&since={since}&limit={limit}
Sample request
GET https://nethunt.com/api/v1/zapier/triggers/record-change/596f710ef5be7653dee0da14?fieldName=Primary%20Email%20Address&fieldName=Other%20Email%20Addresses&since=2015-01-01T00%3A00%3A00.000Z&limit=1
Request parameterDescriptionDefault value
folderIdFolder IDRequired
recordIdRecord ID to look for single record changesIf missing, changes for all folder records are returned
fieldNameField name to limit changes observedOptional, multiple parameters with the same name allowed
sinceOnly changes made after this time are returned24 hours before time of request
limitMaximum number of changes to returnNo limit
Sample result
[
    {
        "id": "597084cc39b70d3b5959c604",
        "recordId": "596f644b8f6d05e16c24b830",
        "time": "2017-03-01T12:30:10.510Z",
        "user": {
            "personalName": "Jane Doe",
            "emailAddress": "<jane.doe@example.com>"
        },
        "recordAction": "DELETE"
    },
    {
        "id": "597084cc39b70d3b5959c603",
        "recordId": "596f644b8f6d05e16c24b830",
        "time": "2015-03-01T12:30:10.510Z",
        "user": {
            "personalName": "Jane Doe",
            "emailAddress": "<jane.doe@example.com>"
        },
        "recordAction": "UPDATE",
        "fieldActions": {
            "Salary": {
                "remove": 100000,
                "add": 200000
            },
            "Keywords": {
                "remove": [
                    "Java"
                ],
                "add": [
                    "JavaScript"
                ]
            }
        }
    },
    {
        "id": "597084cc39b70d3b5959c602",
        "recordId": "596f644b8f6d05e16c24b830",
        "time": "2015-02-01T12:30:10.510Z",
        "user": {
            "personalName": "John Doe",
            "emailAddress": "<john.doe@example.com>"
        },
        "recordAction": "CREATE",
        "fieldActions": {
            "Name": {
                "add": "John Doe"
            },
            "Birthday": {
                "add": "1980-01-01"
            },
            "Employed": {
                "add": true
            },
            "Salary": {
                "add": 100000
            },
            "Keywords": {
                "add": [
                    "Java",
                    "Big Data"
                ]
            },
            "Primary Email Address": {
                "add": "John Doe <john.doe@example.com>"
            },
            "Other Email Addresses": {
                "add": [
                    "J. Doe <j.doe@example.com>",
                    "J. D. <j.d@example.com>"
                ]
            },
            "Co-workers": {
                "add": [
                    "596f64368f6d05e16c24b833",
                    "596f644b8f6d05e16c24b834"
                ]
            }
        }
    }
]
                
Result fieldsDescription
idFor internal purposes only
recordIdRecord ID
timeTime of record change
userUser who made that change
recordActionOne of CREATE, UPDATE, DELETE
fieldActionsNames of record fields along with actual changes made to them

Create a new record

POST /actions/create-record/{folderId}
Sample request
POST https://nethunt.com/api/v1/zapier/actions/create-record/596f710ef5be7653dee0da14
                {
                    "timeZone": "Europe/London",
                    "fields": {
                        "Name": "John Doe",
                        "Birthday": "1980-01-01",
                        "Employed": true,
                        "Salary": 100000,
                        "Keywords": [
                            "Java",
                            "Big Data"
                        ],
                        "Primary Email Address": "John Doe <john.doe@example.com>",
                        "Other Email Addresses": [
                            "J. Doe <j.doe@example.com>",
                            "J. D. <j.d@example.com>"
                        ],
                        "Co-workers": [
                            "596f64368f6d05e16c24b833",
                            "596f644b8f6d05e16c24b834"
                        ]
                    }
                }
                
Request parameters and fieldsDescriptionDefault value
folderIdFolder ID to create a record inRequired
timeZoneUser time zoneRequired
fieldsField names and valuesRequired
Sample result
{
    "recordId": "596f644b8f6d05e16c24b830",
    "createdAt": "2015-01-01T12:34:15.880Z",
    "fields": {
        "Name": "John Doe",
        "Birthday": "1980-01-01",
        "Employed": true,
        "Salary": 100000,
        "Keywords": [
            "Java",
            "Big Data"
        ],
        "Primary Email Address": "John Doe <john.doe@example.com>",
        "Other Email Addresses": [
            "J. Doe <j.doe@example.com>",
            "J. D. <j.d@example.com>"
        ],
        "Co-workers": [
            "596f64368f6d05e16c24b833",
            "596f644b8f6d05e16c24b834"
        ]
    }
}
                
Result fieldsDescription
recordIdRecord ID
createdAtTime of record creation
fieldsField names and values

Create a new record comment

POST /actions/create-comment/{recordId}
Sample request
POST https://nethunt.com/api/v1/zapier/actions/create-comment/596f644b8f6d05e16c24b830
{
    "text": "It's a comment"
}
                
Request parameters and fieldsDescriptionDefault value
recordIdRecord ID to create a comment forRequired
textActual comment textRequired
Sample result
{
    "commentId": "5970b408bbd55ad726e11bc3",
    "createdAt": "2015-01-01T12:34:15.880Z"
}
                
Result fieldsDescription
commentIdComment ID
createdAtTime of comment creation

Create a new record call log

POST /actions/create-call-log/{recordId}
Sample request
POST https://nethunt.com/api/v1/zapier/actions/create-call-log/596f644b8f6d05e16c24b830
{
    "text": "It's a call log",
    "time": "2015-01-01T12:35:00Z",
    "duration": 2.5
}
                
Request parameters and fieldsDescriptionDefault value
recordIdRecord ID to create a call log forRequired
textActual call log textRequired
timeISO-formatted time in UTC when the call started
durationCall log duration in minutes
Sample result
{
    "callLogId": "5970b408bbd55ad726e11bc3",
    "createdAt": "2015-01-01T12:34:15.880Z"
}
                
Result fieldsDescription
callLogIdCall Log ID
createdAtTime of call log creation

Update a record

POST /zapier/actions/update-record/{recordId}?overwrite={overwrite}
Sample request
POST https://nethunt.com/api/v1/zapier/actions/update-record/596f644b8f6d05e16c24b830
{
    "fieldActions": {
        "Name": {
            "overwrite": true,
            "add": "John Doe"
        },
        "Salary": {
            "remove": 100000,
            "add": 200000
        },
        "Keywords": {
            "remove": [
                "Java"
            ],
            "add": [
                "JavaScript"
            ]
        }
    }
}
                
Request parameters and fieldsDescriptionDefault value
recordIdRecord IDRequired
overwriteDefault "overwrite" setting for the field actionsfalse
fieldActionsNames of record fields along with actions to performRequired
Field action fieldsDescriptionDefault value
overwriteClears existing record field value (do not use with "remove")If missing, the query parameter "overwrite" is used
removeValue(s) to remove (do not use with "overwrite" enabled)Optional
addValue(s) to add to the field. If the field can hold only single value and is not empty, either "remove" or "overwrite" must be used.Optional
Sample result
{
    "recordId": "596f644b8f6d05e16c24b830",
    "updatedAt": "2015-01-05T12:34:15.880Z",
    "fields": {
        "Name": "John Doe",
        "Birthday": "1980-01-01",
        "Employed": true,
        "Salary": 200000,
        "Keywords": [
            "Big Data",
            "JavaScript"
        ],
        "Primary Email Address": "John Doe <john.doe@example.com>",
        "Other Email Addresses": [
            "J. Doe <j.doe@example.com>",
            "J. D. <j.d@example.com>"
        ],
        "Co-workers": [
            "596f64368f6d05e16c24b833",
            "596f644b8f6d05e16c24b834"
        ]
    }
}
                
Result fieldsDescription
recordIdRecord ID
updatedAtTime of last record update
fieldsField names and values

Verify request credentials

GET /triggers/auth-test
Sample request
GET https://nethunt.com/api/v1/zapier/triggers/auth-test
Sample result
[
    {
        "user": {
            "personalName": "John Doe",
            "emailAddress": "john.doe@example.com"
        }
    }
]
                
Result fieldsDescription
userName and email address of the user who makes the request

NetHunt CRM for Gmail

Your smart Inbox

Get NetHunt CRM

We use cookies to enable more personalized website experience and offer you more relevant information.
Read our Privacy Policy to learn more. By continuing to use this site, you are agreeing to our use of cookies.

What day can be better than Friday?

Black Friday!

Save 40% on NetHunt plans

Get the Deal