Less Annoying CRM logo Less Annoying CRM LACRM
Core API Functions

Contacts / Companies

Note: Less Annoying CRM has both contact and company records, but they’re all considered contacts by the API. Even though the function names all say “contact” you can call them to interact with companies in the exact same way.

Contacts are the main record type in Less Annoying CRM. Most other types of objects (tasks, events, relationships, files, etc.) can be attached to contacts, so regardless of what you’re building, you’ll probably need to interact with contacts.

Contacts can have custom fields, which means the specific parameters and return values for your account might be slightly different than what we show in the function definitions below. In addition, companies can have a set of custom fields that differ from the ones for your contacts - use the dropdown found above the function definitions to show parameters and return values for both contacts & companies.

Create a contact

This function creates a new contact or company in the CRM.

Note: Because fields can be customized, they're different on every account. This documentation shows fields for an example LACRM account. Please log in to see the fields for your specific account.
Showing fields for the
records.
How to call this function
Function name
CreateContact
Parameters
IsCompany Bool Required

Whether this record is a contact or company record. If true, it will create a company record.

AssignedTo Uid Required

The id of the user this contact should be assigned to.

Name Text Required

The full name of the contact or company record. If this is a company record, the name must be unique.

The email address(es) for this contact. Can be a single string, an array of strings, or an array of Email objects.

Each item in the array should be an object with the following fields:
Text Text

The actual email address (e.g. test@fake.com) for this contact.

Type Text

The type of this email address (e.g. Work, Personal, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

The phone number(s) for this contact. Can be a single string, an array of strings, or an array of Phone objects.

Each item in the array should be an object with the following fields:
Text Text

The actual phone number for this contact.

Type Text

The type of this phone number (e.g. Work, Mobile, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

Company Name Text

The name of the company this contact works at. If the company does not exist in the CRM, a new company record will be created.

Job Title Text

The text to store in this field.

The address(es) for this contact. Can be a single string, an array of strings, or an array of Address objects.

Each item in the array should be an object with the following fields:
Street Text

The street address for this contact.

City Text

The city for this contact.

State Text

The state for this contact.

Zip Text

The zip code for this contact.

Country Text

The country for this contact.

Type Text

The type of this address (e.g. Work, Home, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

Background Info Text

The text to store in this field.

The website(s) for this contact. Can be a single string, an array of strings, or an array of Website objects.

Each item in the array should be an object with the following fields:
Text Text

The actual website for this contact.

Birthday Date

The date value for this field. If the field is an annual date, 0000-M-D is preferred if no year is specified but M-D is also accepted.

IsCompany Bool Required

Whether this record is a contact or company record. If true, it will create a company record.

AssignedTo Uid Required

The id of the user this contact should be assigned to.

Company Name Text Required

The full name of the contact or company record. If this is a company record, the name must be unique.

The email address(es) for this contact. Can be a single string, an array of strings, or an array of Email objects.

Each item in the array should be an object with the following fields:
Text Text

The actual email address (e.g. test@fake.com) for this contact.

Type Text

The type of this email address (e.g. Work, Personal, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

The phone number(s) for this contact. Can be a single string, an array of strings, or an array of Phone objects.

Each item in the array should be an object with the following fields:
Text Text

The actual phone number for this contact.

Type Text

The type of this phone number (e.g. Work, Mobile, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

The address(es) for this contact. Can be a single string, an array of strings, or an array of Address objects.

Each item in the array should be an object with the following fields:
Street Text

The street address for this contact.

City Text

The city for this contact.

State Text

The state for this contact.

Zip Text

The zip code for this contact.

Country Text

The country for this contact.

Type Text

The type of this address (e.g. Work, Home, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

Background Info Text

The text to store in this field.

The website(s) for this contact. Can be a single string, an array of strings, or an array of Website objects.

Each item in the array should be an object with the following fields:
Text Text

The actual website for this contact.

Response
{
"ContactId": "3946955517006873876344701467957"
}

Edit a contact

This function edits a contact or company.

Note: Because fields can be customized, they're different on every account. This documentation shows fields for an example LACRM account. Please log in to see the fields for your specific account.
Showing fields for the
records.
How to call this function
Function name
EditContact
Parameters
ContactId Uid Required

The id of the contact to edit.

AssignedTo Uid

The id of the user this contact should be assigned to.

Name Text

The full name of the contact or company record. If this is a company record, the name must be unique.

The email address(es) for this contact. Can be a single string, an array of strings, or an array of Email objects.

Each item in the array should be an object with the following fields:
Text Text

The actual email address (e.g. test@fake.com) for this contact.

Type Text

The type of this email address (e.g. Work, Personal, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

The phone number(s) for this contact. Can be a single string, an array of strings, or an array of Phone objects.

Each item in the array should be an object with the following fields:
Text Text

The actual phone number for this contact.

Type Text

The type of this phone number (e.g. Work, Mobile, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

Company Name Text

The name of the company this contact works at. If the company does not exist in the CRM, a new company record will be created.

Job Title Text

The text to store in this field.

The address(es) for this contact. Can be a single string, an array of strings, or an array of Address objects.

Each item in the array should be an object with the following fields:
Street Text

The street address for this contact.

City Text

The city for this contact.

State Text

The state for this contact.

Zip Text

The zip code for this contact.

Country Text

The country for this contact.

Type Text

The type of this address (e.g. Work, Home, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

Background Info Text

The text to store in this field.

The website(s) for this contact. Can be a single string, an array of strings, or an array of Website objects.

Each item in the array should be an object with the following fields:
Text Text

The actual website for this contact.

Birthday Date

The date value for this field. If the field is an annual date, 0000-M-D is preferred if no year is specified but M-D is also accepted.

ContactId Uid Required

The id of the contact to edit.

AssignedTo Uid

The id of the user this contact should be assigned to.

Company Name Text

The full name of the contact or company record. If this is a company record, the name must be unique.

The email address(es) for this contact. Can be a single string, an array of strings, or an array of Email objects.

Each item in the array should be an object with the following fields:
Text Text

The actual email address (e.g. test@fake.com) for this contact.

Type Text

The type of this email address (e.g. Work, Personal, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

The phone number(s) for this contact. Can be a single string, an array of strings, or an array of Phone objects.

Each item in the array should be an object with the following fields:
Text Text

The actual phone number for this contact.

Type Text

The type of this phone number (e.g. Work, Mobile, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

The address(es) for this contact. Can be a single string, an array of strings, or an array of Address objects.

Each item in the array should be an object with the following fields:
Street Text

The street address for this contact.

City Text

The city for this contact.

State Text

The state for this contact.

Zip Text

The zip code for this contact.

Country Text

The country for this contact.

Type Text

The type of this address (e.g. Work, Home, etc.). If you leave this blank, it will default to the first option available. If you pass a value, it must match one of the values in the CRM.

Background Info Text

The text to store in this field.

The website(s) for this contact. Can be a single string, an array of strings, or an array of Website objects.

Each item in the array should be an object with the following fields:
Text Text

The actual website for this contact.

Response
This function doesn't return anything. If there's no error message returned, that means the call was completed successfully.

Delete a contact

This function deletes a contact or company.

How to call this function
Function name
DeleteContact
Parameters
ContactId Uid Required

The Id for the contact you want to delete. If you don't already know the contact's Id, you can find it using GetContacts.

Response
This function doesn't return anything. If there's no error message returned, that means the call was completed successfully.

Get a contact

This function retrieves a contact or company record.

Note: Because fields can be customized, they're different on every account. This documentation shows fields for an example LACRM account. Please log in to see the fields for your specific account.
Showing fields for the
records.
How to call this function
Function name
GetContact
Parameters
ContactId Uid Required

The Id for the contact you want to get. If you don't already know the contacts's Id, you can get it using GetContacts.

Response
{
"ContactId": "3946955517011485562363129679949",
"AssignedTo": 483823,
"IsCompany": false,
"CompanyId": "3946955517011485562363129413279",
"Name": {
"Salutation": "Mr.",
"FirstName": "John",
"MiddleName": "",
"LastName": "Doe",
"Suffix": ""
}
"Email": [
{
"Text": "john.doe@email.com",
"Type": "Work",
"TypeId": "3946955517011485562363129895207"
},
{...},
{...}
]
"Phone": [
{
"Text": "(314) 555-5555",
"Type": "Work",
"TypeId": "3946955517013791405372342751166"
},
{...},
{...}
]
"Company Name": "",
"Job Title": "",
"Address": [
{
"Street": "123 Main Street",
"City": "St. Louis",
"State": "MO",
"Zip": "63101",
"Country": "USA",
"Type": "Work",
"TypeId": "3946955517013791405372343455368"
},
{...},
{...}
]
"Background Info": "",
"Website": [
{
"Text": "www.lessannoyingcrm.com"
},
{...},
{...}
]
"Birthday": "2024-03-29",
"CompanyMetaData": {
"CompanyName": ""
}
"DateCreated": "2024-03-29T06:31:38-07:00",
"LastUpdate": "2024-03-29T06:31:38-07:00",
"UserMetaData": {
"FirstName": "Your",
"LastName": "Name"
}
}
{
"ContactId": "3946955517016097248381557578631",
"AssignedTo": 483823,
"IsCompany": true,
"Company Name": "B&B Enterprises",
"Email": [
{
"Text": "john.doe@email.com",
"Type": "Work",
"TypeId": "3946955517016097248381557240690"
},
{...},
{...}
]
"Phone": [
{
"Text": "(314) 555-5555",
"Type": "Work",
"TypeId": "3946955517018403091390771376036"
},
{...},
{...}
]
"Address": [
{
"Street": "123 Main Street",
"City": "St. Louis",
"State": "MO",
"Zip": "63101",
"Country": "USA",
"Type": "Work",
"TypeId": "3946955517018403091390771679616"
},
{...},
{...}
]
"Background Info": "",
"Website": [
{
"Text": "www.lessannoyingcrm.com"
},
{...},
{...}
]
"DateCreated": "2024-03-29T06:31:38-07:00",
"LastUpdate": "2024-03-29T06:31:38-07:00",
"UserMetaData": {
"FirstName": "Your",
"LastName": "Name"
}
}

Get a batch of contacts

This function retrieves a set of contact or company records from a user's account.

Note: Because fields can be customized, they're different on every account. This documentation shows fields for an example LACRM account. Please log in to see the fields for your specific account.
Showing fields for the
records.
How to call this function
Function name
GetContactsById
Parameters
ContactIds Array of Uids Required

List of Ids for the contacts you want to get. If you don't already know the contacts' Ids, you can get them using GetContacts.

MaxNumberOfResults Number Default: 500

How many results should be returned from a single API call? The max value is 10,000. If you need to return more results, call this API function again, but increment the Page parameter.

Page Number Default: 1

If there are more results than MaxNumberOfResults, you can call this function again with an incremented Page value to get the next page of results. For example, if there are 700 results, but you're only requesting 500 at a time, you could call this function with Page=2 to get the remaining 200 results.

Response
{
"HasMoreResults": false,
"Results": [
{
Multi-type. Example output for type Contact:
{
"ContactId": "3946955517020708934399984348684",
"AssignedTo": 483823,
"IsCompany": false,
"CompanyId": "3946955517023014777409198655937",
"Name": {
"Salutation": "Mr.",
"FirstName": "John",
"MiddleName": "",
"LastName": "Doe",
"Suffix": ""
}
"Email": [
{
"Text": "john.doe@email.com",
"Type": "Work",
"TypeId": "3946955517023014777409198605152"
},
{...},
{...}
]
"Phone": [
{
"Text": "(314) 555-5555",
"Type": "Work",
"TypeId": "3946955517023014777409197579758"
},
{...},
{...}
]
"Company Name": "",
"Job Title": "",
"Address": [
{
"Street": "123 Main Street",
"City": "St. Louis",
"State": "MO",
"Zip": "63101",
"Country": "USA",
"Type": "Work",
"TypeId": "3946955517023014777409197963451"
},
{...},
{...}
]
"Background Info": "",
"Website": [
{
"Text": "www.lessannoyingcrm.com"
},
{...},
{...}
]
"Birthday": "2024-03-29",
"CompanyMetaData": {
"CompanyName": ""
}
"DateCreated": "2024-03-29T06:31:38-07:00",
"LastUpdate": "2024-03-29T06:31:38-07:00",
"UserMetaData": {
"FirstName": "Your",
"LastName": "Name"
}
}
Multi-type. Example output for type Company:
{
"ContactId": "3946955517023014777409198317390",
"AssignedTo": 483823,
"IsCompany": true,
"Company Name": "B&B Enterprises",
"Email": [
{
"Text": "john.doe@email.com",
"Type": "Work",
"TypeId": "3946955517023014777409198299291"
},
{...},
{...}
]
"Phone": [
{
"Text": "(314) 555-5555",
"Type": "Work",
"TypeId": "3946955517023014777409199078087"
},
{...},
{...}
]
"Address": [
{
"Street": "123 Main Street",
"City": "St. Louis",
"State": "MO",
"Zip": "63101",
"Country": "USA",
"Type": "Work",
"TypeId": "3946955517025320620418410976537"
},
{...},
{...}
]
"Background Info": "",
"Website": [
{
"Text": "www.lessannoyingcrm.com"
},
{...},
{...}
]
"DateCreated": "2024-03-29T06:31:38-07:00",
"LastUpdate": "2024-03-29T06:31:38-07:00",
"UserMetaData": {
"FirstName": "Your",
"LastName": "Name"
}
}
},
{...},
{...}
]
}

Search or list all contacts

Given search terms, return a list of matching contacts. If no search terms are provided, return all contacts. The advanced filter system is documented here.

Note: Because fields can be customized, they're different on every account. This documentation shows fields for an example LACRM account. Please log in to see the fields for your specific account.
Showing fields for the
records.
How to call this function
Function name
GetContacts
Parameters
SearchTerms Text

Values to search for in record fields.

RequiresWriteAccess Bool Default: false

If true, only return contacts that the current user has permission to edit.

RecordTypeFilter Enum Default: NULL
Valid options: Contacts, Companies

Limits the type of records that get returned from this function.

OwnerFilter Array of Uids Default: []

Only returns contacts assigned to these UserIds. If null, return all contacts.

SortBy Enum Default: Relevance
Valid options: Relevance, FirstName, LastName, CompanyName, DateCreated, LastUpdate

Which field to sort by; by default, will use a ranking heuristic.

SortDirection Enum Default: Descending
Valid options: Ascending, Descending

Direction for sort order.

AdvancedFilters Array of objects

List of filters to apply to search results. See documentation here.

Each item in the array should be an object with the following fields:
Name Text Required

Name of field to filter on.

Operation Text Required

Type of filter operation to perform.

Value Default: NULL

Value to filter on.

MaxNumberOfResults Number Default: 500

How many results should be returned from a single API call? The max value is 10,000. If you need to return more results, call this API function again, but increment the Page parameter.

Page Number Default: 1

If there are more results than MaxNumberOfResults, you can call this function again with an incremented Page value to get the next page of results. For example, if there are 700 results, but you're only requesting 500 at a time, you could call this function with Page=2 to get the remaining 200 results.

Response
{
"HasMoreResults": false,
"Results": [
{
Multi-type. Example output for type Contact:
{
"ContactId": "3946955517027626463427624483005",
"AssignedTo": 483823,
"IsCompany": false,
"CompanyId": "3946955517029932306436840045735",
"Name": {
"Salutation": "Mr.",
"FirstName": "John",
"MiddleName": "",
"LastName": "Doe",
"Suffix": ""
}
"Email": [
{
"Text": "john.doe@email.com",
"Type": "Work",
"TypeId": "3946955517029932306436838669866"
},
{...},
{...}
]
"Phone": [
{
"Text": "(314) 555-5555",
"Type": "Work",
"TypeId": "3946955517029932306436839123825"
},
{...},
{...}
]
"Company Name": "",
"Job Title": "",
"Address": [
{
"Street": "123 Main Street",
"City": "St. Louis",
"State": "MO",
"Zip": "63101",
"Country": "USA",
"Type": "Work",
"TypeId": "3946955517029932306436838552736"
},
{...},
{...}
]
"Background Info": "",
"Website": [
{
"Text": "www.lessannoyingcrm.com"
},
{...},
{...}
]
"Birthday": "2024-03-29",
"CompanyMetaData": {
"CompanyName": ""
}
"DateCreated": "2024-03-29T06:31:38-07:00",
"LastUpdate": "2024-03-29T06:31:38-07:00",
"UserMetaData": {
"FirstName": "Your",
"LastName": "Name"
}
}
Multi-type. Example output for type Company:
{
"ContactId": "3946955517029932306436839505978",
"AssignedTo": 483823,
"IsCompany": true,
"Company Name": "B&B Enterprises",
"Email": [
{
"Text": "john.doe@email.com",
"Type": "Work",
"TypeId": "3946955517029932306436840003976"
},
{...},
{...}
]
"Phone": [
{
"Text": "(314) 555-5555",
"Type": "Work",
"TypeId": "3946955517029932306436838405790"
},
{...},
{...}
]
"Address": [
{
"Street": "123 Main Street",
"City": "St. Louis",
"State": "MO",
"Zip": "63101",
"Country": "USA",
"Type": "Work",
"TypeId": "3946955517032238149446052336048"
},
{...},
{...}
]
"Background Info": "",
"Website": [
{
"Text": "www.lessannoyingcrm.com"
},
{...},
{...}
]
"DateCreated": "2024-03-29T06:31:38-07:00",
"LastUpdate": "2024-03-29T06:31:38-07:00",
"UserMetaData": {
"FirstName": "Your",
"LastName": "Name"
}
}
},
{...},
{...}
]
}