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	-
email	Email	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
}