Update a custom field value for contact

PUT  https://:account.api-us1.com/api/3/fieldValues/id

• JSON

{
    "fieldValue": {
        "contact": 4,
        "field": 24,
        "value": "Blue"
    }
}

 

200 OK

{
    "contacts": [
        {
            "cdate": "2018-08-06T16:56:43-05:00",
            "email": "[e-mail]",
            "phone": "",
            "firstName": "John",
            "lastName": "Doe",
            "orgid": "0",
            "segmentio_id": "",
            "bounced_hard": "0",
            "bounced_soft": "0",
            "bounced_date": "0000-00-00",
            "ip": "4",
            "ua": "",
            "hash": "867d56644591991f6b50e1cb913f038b",
            "socialdata_lastcheck": "0000-00-00 00:00:00",
            "email_local": "",
            "email_domain": "",
            "sentcnt": "0",
            "rating_tstamp": "0000-00-00",
            "gravatar": "0",
            "deleted": "0",
            "anonymized": "0",
            "adate": "2018-10-24T13:33:06-05:00",
            "udate": "2018-10-24T13:33:11-05:00",
            "edate": "2018-10-24T13:33:07-05:00",
            "deleted_at": "0000-00-00 00:00:00",
            "created_utc_timestamp": "2018-09-21 12:04:48",
            "updated_utc_timestamp": "2018-10-24 13:33:11",
            "links": {
                "bounceLogs": "https://:account.api-us1.com/api/:version/contacts/24/bounceLogs",
                "contactAutomations": "https://:account.api-us1.com/api/:version/contacts/24/contactAutomations",
                "contactData": "https://:account.api-us1.com/api/:version/contacts/24/contactData",
                "contactGoals": "https://:account.api-us1.com/api/:version/contacts/24/contactGoals",
                "contactLists": "https://:account.api-us1.com/api/:version/contacts/24/contactLists",
                "contactLogs": "https://:account.api-us1.com/api/:version/contacts/24/contactLogs",
                "contactTags": "https://:account.api-us1.com/api/:version/contacts/24/contactTags",
                "contactDeals": "https://:account.api-us1.com/api/:version/contacts/24/contactDeals",
                "deals": "https://:account.api-us1.com/api/:version/contacts/24/deals",
                "fieldValues": "https://:account.api-us1.com/api/:version/contacts/24/fieldValues",
                "geoIps": "https://:account.api-us1.com/api/:version/contacts/24/geoIps",
                "notes": "https://:account.api-us1.com/api/:version/contacts/24/notes",
                "organization": "https://:account.api-us1.com/api/:version/contacts/24/organization",
                "plusAppend": "https://:account.api-us1.com/api/:version/contacts/24/plusAppend",
                "trackingLogs": "https://:account.api-us1.com/api/:version/contacts/24/trackingLogs",
                "scoreValues": "https://:account.api-us1.com/api/:version/contacts/24/scoreValues"
            },
            "id": "24",
            "organization": null
        }
    ],
    "fieldValue": {
        "contact": 4,
        "field": 24,
        "value": "Blue",
        "cdate": "2018-10-24T13:32:52-05:00",
        "udate": "2018-10-24T13:33:11-05:00",
        "links": {
            "owner": "https://:account.api-us1.com/api/:version/fieldValues/15/owner",
            "field": "https://:account.api-us1.com/api/:version/fieldValues/15/field"
        },
        "owner": 4,
        "id": "15"
    }
}

PATH PARAMS

id                                     REQUIRED

string                               ID of the fieldValue to update

 

BODY PARAMS

fieldValue

object

 

fieldValue.contact          REQUIRED

string                               ID of the contact whose field value you're updating

fieldValue.field               REQUIRED

string                               ID of the custom field whose value you're updating for the contact

fieldValue.value              REQUIRED

string                               Value for the field that you're updating