Update Contact Record by Email

PUT https://restapi.actonsoftware.com/api/1/list/{listid}/record?email={emailaddress}

This endpoint allows you to update a record by specifying their email address.

Parameters

Name Parameter
Type
Allow
Multiple
Required/
Optional
Data Type Description
Authorization: Header False Required String Insert your generated access token.
("Bearer {access token}")
listid Path False Required String Specify the ID of the list being updated.
email Query False Required String Specify the email address of the record.
async Query False Optional String Do you want to run the request synchronous or asynchronous?
("Y", "N")
Body False Required String A JSON formatted object to describe the structure of the record that is being added.

Parameter Notes

email

Only the first record matching that email address is updated with the data you provide and if no record is found a new record is added to the list.

Response

{
  "status": "success",
  "message": "Record updated",
  "id": "l-0002:3",
  "contact_id": "l-0002:3"
}

Code Examples

curl -X PUT 'https://restapi.actonsoftware.com/api/1/list/l-0002/record?email=john.doe@act-on.com' -H 'Authorization: Bearer 12345678-9abc-defg-hijk-lmnopqrs' -H 'Content-Type: application/json' -d '{"E-mail Address":"john.doe@act-on.com","First Name":"John","Last Name":"Doe"}'