PUT https://api.actonsoftware.com/api/1/list/{listid}/record?email={emailaddress}
This endpoint allows you to update a record by specifying their email address.
Customers wanting to access our API via our gateway in the EU can use this link:
PUT https://api-eu.actonsoftware.com/api/1/list/{listid}/record?email={emailaddress}
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. |
| 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
curl -X PUT 'https://api.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"}'