| URL | https://(subdomain).matters.cloud/api/v1/contacts |
| Methods Supported | GET, PUT, POST, DELETE |
| Description | Allows you to create individual contacts Allows you to retrieve a list of contacts Allows you to update details on a contact Allows you to delete a contact |
| Id | Internal unique identifier |
| First name | First name of contact person |
| Middle name | Middle name of contact person |
| Last name | Last name of contact person |
| User id | Unique identifier of user who is listed as the contact owner |
| Job title | Job title of contact person |
| Home phone | Home phone number of contact person |
| Business phone | Business phone number of contact person |
| Mobile phone | Mobile phone number of contact person |
| Email address of contact person | |
| Organization id | Unique identifier of organization who is listed as the primary contact employer |
The most common filters have been added to allow results to be filtered, for example:
When using individually or combined with the AND operator:
| First name | equals | first_name=Aaron | |
| Middle name | equals | middle_name=John | |
| Last name | equals | last_name=Francis |
When you are updating a contact you don’t need to specify every element. If you exclude an element then the existing value will be preserved.
The following is required to create a contact
| First name | First name of contact person |
The following are optional when creating/updating contacts
| Middle name | Middle name of contact person |
| Last name | Last name of contact person |
| User id | Unique identifier of user who is listed as the contact owner |
| Job title | Job title of contact person |
| Home phone | Home phone number of contact person |
| Business phone | Business phone number of contact person |
| Mobile phone | Mobile phone number of contact person |
| Email address of contact person | |
| Organization id | Unique identifier of organization who is listed as the primary contact employer |