Edit contact
API URL
URL used to send HTTP requests:
https://portal.bulkgate.com/api/1.0/address-book/edit
POST /api/1.0/address-book/edit HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
Cache-Control: no-cache
Parameters table
PARAMETER NAME | VALUE | MANDATORY | DEFAULT VALUE |
---|---|---|---|
application_id | Application ID | Yes | - |
application_token | Application token | Yes | - |
phone_number | Phone number of contact to be edited. | Yes | - |
data | Contact information | Yes | Data object |
Data object
PARAMETER NAME | VALUE | MANDATORY | DEFAULT VALUE |
---|---|---|---|
type | Person/Company | No | - |
phone_mobile | Main phone number | No | - |
phone | Secondary phone number | No | - |
title_before | Title before name | No | - |
first_name | First name | No | - |
last_name | Last name | No | - |
title_after | Title after name | No | - |
gender | male/female/unknown | No | unknown |
company_name | Name of your company | No | - |
No | - | ||
url | Url | No | - |
street1 | 1. Street address | No | - |
street2 | 2. Street address | No | - |
city | City | No | - |
zip | Zip code | No | - |
state | State | No | - |
country | Country code in ISO 3166-1 alpha-2 format. | No | null |
company_number | Company number | No | - |
company_vat | Company vat | No | - |
note | Note | No | - |
custom_field_0 | Custom field | No | - |
custom_field_1 | Custom field | No | - |
custom_field_2 | Custom field | No | - |
custom_field_3 | Custom field | No | - |
custom_field_4 | Custom field | No | - |
custom_field_5 | Custom field | No | - |
custom_field_6 | Custom field | No | - |
custom_field_7 | Custom field | No | - |
custom_field_8 | Custom field | No | - |
custom_field_9 | Custom field | No | - |
Example of full request
POST /api/1.0/address-book/edit HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
Cache-Control: no-cache
{
"application_id": "####",
"application_token": "##################################################",
"phone_number": "123456789",
"data": {
"first_name": "Morgan",
"last_name": "Yu",
"phone_mobile": "123456789",
"street1": "Crew's quarters",
"street2": "Executive suite",
"country": "Talos 1",
"email": "morganyu@talos.com"
}
}
Response to this command may be:
In case of success:
{
"data": {
"message": "contact_has_been_edited"
}
}
In case of error:
{
"type": "number_not_found",
"code": 400,
"error": "Number not found",
"detail": null
}
{
"type": "invalid_phone_number",
"code": 400,
"error": "Invalid phone number",
"detail": null
}
{
"type": "invalid_phone_mobile",
"code": 400,
"error": "Invalid phone mobile",
"detail": null
}