Create a custom field value

POST  https://:account.api-us1.com/api/3/fieldValues

• text value

{
    "fieldValue": {
        "contact": 2,
        "field": 3,
        "value": "Blue"
    }
}

• dropdown/radio value

{
    "fieldValue": {
        "contact": 2,
        "field": 4,
        "value": "Option 1"
    }
}

• checkbox/listbox values

{
    "fieldValue": {
        "contact": 2,
        "field": 5,
        "value": "||Option 1||Option 3||Option 4||"
    }
}

{
    "fieldValue": {
        "contact": 2,
        "field": 6,
        "value": "||Option 2||"
    }
}

• date value

{
    "fieldValue": {
        "contact": 2,
        "field": 6,
        "value": "2018-12-31"
    }
}

 

200 OK

{
    "contacts": [
        {
            "cdate": "2018-08-06T16:26:04-05:00",
            "email": "[e-mail]",
            "phone": "",
            "firstName": "",
            "lastName": "",
            "orgid": "0",
            "segmentio_id": "",
            "bounced_hard": "0",
            "bounced_soft": "0",
            "bounced_date": null,
            "ip": "0",
            "ua": null,
            "hash": "14d8c4418ae944c68e9dde4a975854cc",
            "socialdata_lastcheck": null,
            "email_local": "",
            "email_domain": "",
            "sentcnt": "0",
            "rating_tstamp": null,
            "gravatar": "0",
            "deleted": "0",
            "anonymized": "0",
            "adate": null,
            "udate": "2018-10-01T17:18:40-05:00",
            "edate": null,
            "deleted_at": null,
            "created_utc_timestamp": "2018-09-21 12:04:40",
            "updated_utc_timestamp": "2018-10-01 17:18:40",
            "links": {
                "bounceLogs": "https://:account.api-us1.com/api/:version/contacts/2/bounceLogs",
                "contactAutomations": "https://:account.api-us1.com/api/:version/contacts/2/contactAutomations",
                "contactData": "https://:account.api-us1.com/api/:version/contacts/2/contactData",
                "contactGoals": "https://:account.api-us1.com/api/:version/contacts/2/contactGoals",
                "contactLists": "https://:account.api-us1.com/api/:version/contacts/2/contactLists",
                "contactLogs": "https://:account.api-us1.com/api/:version/contacts/2/contactLogs",
                "contactTags": "https://:account.api-us1.com/api/:version/contacts/2/contactTags",
                "contactDeals": "https://:account.api-us1.com/api/:version/contacts/2/contactDeals",
                "deals": "https://:account.api-us1.com/api/:version/contacts/2/deals",
                "fieldValues": "https://:account.api-us1.com/api/:version/contacts/2/fieldValues",
                "geoIps": "https://:account.api-us1.com/api/:version/contacts/2/geoIps",
                "notes": "https://:account.api-us1.com/api/:version/contacts/2/notes",
                "organization": "https://:account.api-us1.com/api/:version/contacts/2/organization",
                "plusAppend": "https://:account.api-us1.com/api/:version/contacts/2/plusAppend",
                "trackingLogs": "https://:account.api-us1.com/api/:version/contacts/2/trackingLogs",
                "scoreValues": "https://:account.api-us1.com/api/:version/contacts/2/scoreValues"
            },
            "id": "2",
            "organization": null
        }
    ],
    "fieldValue": {
        "contact": 2,
        "field": 3,
        "value": "Blue",
        "cdate": "2018-10-01T17:18:40-05:00",
        "udate": "2018-10-01T17:18:40-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": 2,
        "id": "15"
    }
}

403 Forbidden

{
    "message": "Forbidden"
}

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. For multi-select options this needs to be in the format of ||option1||option2||