Update Contact List Contact
Updates a contact within a specified contact list. The contact is identified by email address. Include only the fields you want to change.
Endpoint
POST
v5/contactlist/{list_id}/contactlistcontact
Requires authentication
Path Parameters
The contact list containing the contact to update.
list_id
string
required
The ID of the contact list.
Query Parameters
email_address
string
required
The email address of the contact to update. Used to identify the contact.
status
string
Updated status. Values:
Active, Inactive.first_name
string
Updated first name.
last_name
string
Updated last name.
organization
string
Updated organization.
division
string
Updated division.
department
string
Updated department.
group
string
Updated group.
role
string
Updated role.
is_manager
boolean
Updated manager flag.
team
string
Updated team.
home_phone
string
Updated home phone number.
fax_phone
string
Updated fax number.
business_phone
string
Updated business phone number.
mailing_address
string
Updated mailing address (line 1).
mailing_address2
string
Updated mailing address (line 2).
mailing_address_city
string
Updated city.
mailing_address_state
string
Updated state or province.
mailing_address_postal
string
Updated postal or ZIP code.
mailing_address_country
string
Updated country code. Example:
US.title
string
Updated job title.
url
string
Updated website URL.
custom
object
Custom fields to update. Each key is the numeric custom field ID.
child attributes
{field_id}
string
The updated value for the custom field with the given numeric ID. Example:
custom[15]=value.Custom field IDs are account-specific. To find custom field IDs for your contact list, use the Contact Custom Field endpoint.
Response
Returns the updated contact object.
result_ok
boolean
Whether the request succeeded.
data
object
The updated contact object. See List Contact List Contacts for the full list of response fields.
Examples
Request (cURL)
curl -X POST "https://api.alchemer.com/v5/contactlist/YOUR_LIST_ID/contactlistcontact?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET&email_address=jon.doe%40example.com&first_name=Jonathan"
Response
{
"result_ok": true,
"data": {
"id": 100039767,
"email_address": "jon.doe@example.com",
"status": "Active",
"first_name": "Jonathan",
"last_name": "Doe",
"organization": "",
"division": "",
"department": "",
"group": "",
"role": "",
"is_manager": false,
"team": "",
"home_phone": "",
"fax_phone": "",
"business_phone": "",
"mailing_address": "",
"mailing_address2": "",
"mailing_address_city": "",
"mailing_address_state": "",
"mailing_address_postal": "",
"mailing_address_country": "",
"title": "",
"url": ""
}
}