Contacts
List contact
- Endpoint:
GET /contacts
- Allowed for:
Everyone
- Filters:
Name | Type | Comment |
---|---|---|
name | string | Name of the contact |
string | Email of the contact | |
phone | string | Phone of the contact |
or | string | Array of filters for or operator |
-
JSON request data example:
-
By
name
orphone
:/contacts?filters[or][name]=Foo&filters[or][phone]=12345
- By
name
andemail
orphone
:/contacts?filters[name]=illusion&filters[or][email]=test@mycrm&filters[or][phone]=12345
Create contact
- Endpoint:
POST /contacts/{type}
type
is linkedin_person
, linkedin_company
, external_person
or external_company
.
- Allowed for:
Everyone
- JSON request data
In order to create a LinkedIn person contact, please send the following payload under the contact
key:
Name | Type | Mandatory | Comment |
---|---|---|---|
linkedin_id | int | yes | LinkedIn Id |
first_name | string | yes | Contact first name |
last_name | string | yes | Contact last name |
headline | string | no | Contact headline title |
string | no | Contact email address | |
profile_url | string | no | Contact profile url |
profile_picture | string | no | Contact profile pic |
In order to create a LinkedIn company contact, please send the following payload under the contact
key:
Name | Type | Mandatory | Comment |
---|---|---|---|
linkedin_id | int | yes | LinkedIn Id |
name | string | yes | Contact company name |
In order to create a external person contact, please send the following payload under the contact
key:
Name | Type | Mandatory | Comment |
---|---|---|---|
first_name | string | yes (one among first_name or last_name) | First name |
last_name | string | yes (one among first_name or last_name) | Last name |
company | string | no | Company |
string | yes (one among email or mobile) | Email address | |
mobile | string | yes (one among email or mobile) | Linkedin profile url |
address | string | no | Address |
licence | string | no | Licence number |
In order to create a external company contact, please send the following payload under the contact
key:
Name | Type | Mandatory | Comment |
---|---|---|---|
name | string | yes | Company name |
string | yes (one among email or mobile) | ||
phone | string | yes (one among email or mobile) | Phone number (mobile or landline) |
address | string | no | Address |
rera | string | no | Rera licence number |
- JSON request example:
{
"contact": {
"linkedin_id": "3Af70Thj",
"first_name": "Alain",
"last_name": "B",
"head_line": "Foo",
"profile_url": "http:\/\/bar.com"
}
}
- JSON response example:
{
"contact": {
"id": 3,
"linkedin_id": "3Af70Thj",
"first_name": "Alain",
"last_name": "B",
"head_line": "Foo",
"profile_url": "http:\/\/bar.com"
}
}
Update contact
- Endpoint:
PUT /contacts/{type}/{id}
- Allowed for:
Everyone
- JSON request data
Same than POST
request.