Jump to

• Request
• Response
• Examples

Update a contact

put

/api/REST/1.0/data/contact/{id}

Updates the contact specified by the id parameter. All properties should be included in PUT requests, as some properties will be considered blank if not included.

Request

Supported Media Types

• application/json

Path Parameters

• id: integer
  Id of the contact.

Body ()

The request body defines the details of the contact to be updated.

Root Schema : Contact

Type: object

Title: Contact

Show Source

• accountId(optional): string
  The account id in which the contact belongs. This is a read-only property.
• accountName(optional): string
  The account name in which the contact belongs.
• address1(optional): string
  The contact's first address.
• address2(optional): string
  The contact's second address.
• address3(optional): string
  The contact's third address.
• bouncebackDate(optional): string
  The contact's bounceback date.
• businessPhone(optional): string
  The contact's business phone number.
• city(optional): string
  The contact's city.
• country(optional): string
  The contact's country.
• createdAt(optional): string
  Read Only: true

  The date and time the contact was created, expressed in Unix time.
• createdBy(optional): string
  Read Only: true

  The login id of the user who created the contact.
• currentStatus(optional): string
  The contact's current status.
• depth(optional): string
  Read Only: true

  Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: minimal, partial, and complete. Any other values passed are reset to complete by default. For more information, see Request depth.
• description(optional): string
  The description of the contact.
• emailAddress(optional): string
  The contact's email address.
• emailFormatPreference(optional): string
  The contact's email format preference.
• fax(optional): string
  The contact's fax number.
• fieldValues(optional): array fieldValues
  Array containing type and id values for all of the contactFields associated with a given contact.
• firstName(optional): string
  The contact's first name.
• id(optional): string
  Read Only: true

  Id of the contact. This is a read-only property.
• isBounceback(optional): string
  Whether or not the contact has any associated bouncebacks.
• isSubscribed(optional): string
  Whether or not the contact is subscribed.
• lastName(optional): string
  The contact's last name.
• mobilePhone(optional): string
  The contact's mobile phone number.
• name(optional): string
  The name of the contact.
• permissions(optional): string
  The permissions for the contact granted to your current instance. This is a read-only property.
• postalCode(optional): string
  The contact's postal code.
• province(optional): string
  The contact's province.
• salesPerson(optional): string
  The contact's account representative.
• subscriptionDate(optional): string
  The contact's subscription date.
• title(optional): string
  The contact's title.
• type(optional): string
  The asset's type in Eloqua. This is a read-only property.
• unsubscriptionDate(optional): string
  The contact's unsubscription date.
• updatedAt(optional): string
  Read Only: true

  Unix timestamp for the date and time the contact was last updated.
• updatedBy(optional): string
  Read Only: true

  The login id of the user that last updated the contact.

{
    "title":"Contact",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property. "
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"Id of the contact. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The contact's current status."
        },
        "name":{
            "type":"string",
            "description":"The name of the contact."
        },
        "description":{
            "type":"string",
            "description":"The description of the contact."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the contact granted to your current instance. This is a read-only property."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user who created the contact."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the contact was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the contact."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the contact was last updated."
        },
        "depth":{
            "type":"string",
            "readOnly":true,
            "description":"Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: <code>minimal</code>, <code>partial</code>, and <code>complete</code>. Any other values passed are reset to <code>complete</code> by default. For more information, see <a href='https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAB/index.html#CSHID=RequestDepth'>Request depth</a>."
        },
        "firstName":{
            "type":"string",
            "description":"The contact's first name."
        },
        "lastName":{
            "type":"string",
            "description":"The contact's last name."
        },
        "emailAddress":{
            "type":"string",
            "description":"The contact's email address."
        },
        "emailFormatPreference":{
            "type":"string",
            "description":"The contact's email format preference."
        },
        "isSubscribed":{
            "type":"string",
            "description":"Whether or not the contact is subscribed."
        },
        "isBounceback":{
            "type":"string",
            "description":"Whether or not the contact has any associated bouncebacks."
        },
        "accountName":{
            "type":"string",
            "description":"The account name in which the contact belongs."
        },
        "accountId":{
            "type":"string",
            "description":"The account id in which the contact belongs. This is a read-only property."
        },
        "title":{
            "type":"string",
            "description":"The contact's title."
        },
        "subscriptionDate":{
            "type":"string",
            "description":"The contact's subscription date."
        },
        "unsubscriptionDate":{
            "type":"string",
            "description":"The contact's unsubscription date."
        },
        "bouncebackDate":{
            "type":"string",
            "description":"The contact's bounceback date."
        },
        "fieldValues":{
            "type":"array",
            "description":"Array containing <code>type</code> and <code>id</code> values for all of the contactFields associated with a given contact.",
            "items":{
                "$ref":"#/definitions/FieldValueRest10"
            }
        },
        "address1":{
            "type":"string",
            "description":"The contact's first address."
        },
        "address2":{
            "type":"string",
            "description":"The contact's second address."
        },
        "address3":{
            "type":"string",
            "description":"The contact's third address."
        },
        "city":{
            "type":"string",
            "description":"The contact's city."
        },
        "province":{
            "type":"string",
            "description":"The contact's province."
        },
        "postalCode":{
            "type":"string",
            "description":"The contact's postal code."
        },
        "country":{
            "type":"string",
            "description":"The contact's country."
        },
        "businessPhone":{
            "type":"string",
            "description":"The contact's business phone number."
        },
        "mobilePhone":{
            "type":"string",
            "description":"The contact's mobile phone number."
        },
        "fax":{
            "type":"string",
            "description":"The contact's fax number."
        },
        "salesPerson":{
            "type":"string",
            "description":"The contact's account representative."
        }
    }
}

Nested Schema : fieldValues

Type: array

Array containing type and id values for all of the contactFields associated with a given contact.

Show Source

• Array of: object FieldValue
  Title: FieldValue

{
    "type":"array",
    "description":"Array containing <code>type</code> and <code>id</code> values for all of the contactFields associated with a given contact.",
    "items":{
        "$ref":"#/definitions/FieldValueRest10"
    }
}

Nested Schema : FieldValue

Type: object

Title: FieldValue

Show Source

• id(optional): string
  Read Only: true

  The id of the field to be set to the corresponding value.
• type(optional): string
  The asset's type in Eloqua. This is a read-only property.
• value(optional): string
  The value to set the corresponding field id to. Date values must be submitted as a unix timestamp.

{
    "title":"FieldValue",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property."
        },
        "value":{
            "type":"string",
            "description":"The value to set the corresponding field id to. Date values must be submitted as a unix timestamp."
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"The id of the field to be set to the corresponding value."
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : Contact

Type: object

Title: Contact

Show Source

• accountId(optional): string
  The account id in which the contact belongs. This is a read-only property.
• accountName(optional): string
  The account name in which the contact belongs.
• address1(optional): string
  The contact's first address.
• address2(optional): string
  The contact's second address.
• address3(optional): string
  The contact's third address.
• bouncebackDate(optional): string
  The contact's bounceback date.
• businessPhone(optional): string
  The contact's business phone number.
• city(optional): string
  The contact's city.
• country(optional): string
  The contact's country.
• createdAt(optional): string
  Read Only: true

  The date and time the contact was created, expressed in Unix time.
• createdBy(optional): string
  Read Only: true

  The login id of the user who created the contact.
• currentStatus(optional): string
  The contact's current status.
• depth(optional): string
  Read Only: true

  Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: minimal, partial, and complete. Any other values passed are reset to complete by default. For more information, see Request depth.
• description(optional): string
  The description of the contact.
• emailAddress(optional): string
  The contact's email address.
• emailFormatPreference(optional): string
  The contact's email format preference.
• fax(optional): string
  The contact's fax number.
• fieldValues(optional): array fieldValues
  Array containing type and id values for all of the contactFields associated with a given contact.
• firstName(optional): string
  The contact's first name.
• id(optional): string
  Read Only: true

  Id of the contact. This is a read-only property.
• isBounceback(optional): string
  Whether or not the contact has any associated bouncebacks.
• isSubscribed(optional): string
  Whether or not the contact is subscribed.
• lastName(optional): string
  The contact's last name.
• mobilePhone(optional): string
  The contact's mobile phone number.
• name(optional): string
  The name of the contact.
• permissions(optional): string
  The permissions for the contact granted to your current instance. This is a read-only property.
• postalCode(optional): string
  The contact's postal code.
• province(optional): string
  The contact's province.
• salesPerson(optional): string
  The contact's account representative.
• subscriptionDate(optional): string
  The contact's subscription date.
• title(optional): string
  The contact's title.
• type(optional): string
  The asset's type in Eloqua. This is a read-only property.
• unsubscriptionDate(optional): string
  The contact's unsubscription date.
• updatedAt(optional): string
  Read Only: true

  Unix timestamp for the date and time the contact was last updated.
• updatedBy(optional): string
  Read Only: true

  The login id of the user that last updated the contact.

{
    "title":"Contact",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property. "
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"Id of the contact. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The contact's current status."
        },
        "name":{
            "type":"string",
            "description":"The name of the contact."
        },
        "description":{
            "type":"string",
            "description":"The description of the contact."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the contact granted to your current instance. This is a read-only property."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user who created the contact."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the contact was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the contact."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the contact was last updated."
        },
        "depth":{
            "type":"string",
            "readOnly":true,
            "description":"Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: <code>minimal</code>, <code>partial</code>, and <code>complete</code>. Any other values passed are reset to <code>complete</code> by default. For more information, see <a href='https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAB/index.html#CSHID=RequestDepth'>Request depth</a>."
        },
        "firstName":{
            "type":"string",
            "description":"The contact's first name."
        },
        "lastName":{
            "type":"string",
            "description":"The contact's last name."
        },
        "emailAddress":{
            "type":"string",
            "description":"The contact's email address."
        },
        "emailFormatPreference":{
            "type":"string",
            "description":"The contact's email format preference."
        },
        "isSubscribed":{
            "type":"string",
            "description":"Whether or not the contact is subscribed."
        },
        "isBounceback":{
            "type":"string",
            "description":"Whether or not the contact has any associated bouncebacks."
        },
        "accountName":{
            "type":"string",
            "description":"The account name in which the contact belongs."
        },
        "accountId":{
            "type":"string",
            "description":"The account id in which the contact belongs. This is a read-only property."
        },
        "title":{
            "type":"string",
            "description":"The contact's title."
        },
        "subscriptionDate":{
            "type":"string",
            "description":"The contact's subscription date."
        },
        "unsubscriptionDate":{
            "type":"string",
            "description":"The contact's unsubscription date."
        },
        "bouncebackDate":{
            "type":"string",
            "description":"The contact's bounceback date."
        },
        "fieldValues":{
            "type":"array",
            "description":"Array containing <code>type</code> and <code>id</code> values for all of the contactFields associated with a given contact.",
            "items":{
                "$ref":"#/definitions/FieldValueRest10"
            }
        },
        "address1":{
            "type":"string",
            "description":"The contact's first address."
        },
        "address2":{
            "type":"string",
            "description":"The contact's second address."
        },
        "address3":{
            "type":"string",
            "description":"The contact's third address."
        },
        "city":{
            "type":"string",
            "description":"The contact's city."
        },
        "province":{
            "type":"string",
            "description":"The contact's province."
        },
        "postalCode":{
            "type":"string",
            "description":"The contact's postal code."
        },
        "country":{
            "type":"string",
            "description":"The contact's country."
        },
        "businessPhone":{
            "type":"string",
            "description":"The contact's business phone number."
        },
        "mobilePhone":{
            "type":"string",
            "description":"The contact's mobile phone number."
        },
        "fax":{
            "type":"string",
            "description":"The contact's fax number."
        },
        "salesPerson":{
            "type":"string",
            "description":"The contact's account representative."
        }
    }
}

Nested Schema : fieldValues

Type: array

Array containing type and id values for all of the contactFields associated with a given contact.

Show Source

• Array of: object FieldValue
  Title: FieldValue

{
    "type":"array",
    "description":"Array containing <code>type</code> and <code>id</code> values for all of the contactFields associated with a given contact.",
    "items":{
        "$ref":"#/definitions/FieldValueRest10"
    }
}

Nested Schema : FieldValue

Type: object

Title: FieldValue

Show Source

• id(optional): string
  Read Only: true

  The id of the field to be set to the corresponding value.
• type(optional): string
  The asset's type in Eloqua. This is a read-only property.
• value(optional): string
  The value to set the corresponding field id to. Date values must be submitted as a unix timestamp.

{
    "title":"FieldValue",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property."
        },
        "value":{
            "type":"string",
            "description":"The value to set the corresponding field id to. Date values must be submitted as a unix timestamp."
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"The id of the field to be set to the corresponding value."
        }
    }
}

400 Response

Bad request. See Status Codes for information about other possible HTTP status codes.

401 Response

Unauthorized. See Status Codes for information about other possible HTTP status codes.

403 Response

Forbidden. See Status Codes for information about other possible HTTP status codes.

404 Response

The requested resource was not found. See Status Codes for information about other possible HTTP status codes.

500 Response

The service has encountered an error. See Status Codes for information about other possible HTTP status codes.

Back to Top

Examples

Update the email address and phone number of the contact with #Id 22482:

PUT /api/REST/1.0/data/contact/22482
Content-Type: application/json 
			

Request body:

{
    "emailAddress":"[e-mail]",
    "id":"22482",
    "businessPhone":"555-555-5555"
}
			

Response:

{
    "type":"Contact",
    "currentStatus":"Awaiting action",
    "id":"22482",
    "initialId":"22482",
    "createdAt":"1434039531",
    "depth":"complete",
    "name":"[e-mail]",
    "updatedAt":"1434051580",
    "businessPhone":"555-555-5555",
    "emailAddress":"[e-mail]",
    "emailFormatPreference":"unspecified",
    "fieldValues":[
        {
            "type":"FieldValue",
            "id":"100005"
        },
        {
            "type":"FieldValue",
            "id":"100017"
        },
        {
            "type":"FieldValue",
            "id":"100023"
        },
        {
            "type":"FieldValue",
            "id":"100024"
        },
        {
            "type":"FieldValue",
            "id":"100032",
            "value":"CPLTO000000022482"
        },
        {
            "type":"FieldValue",
            "id":"100033"
        },
        {
            "type":"FieldValue",
            "id":"100034"
        },
        {
            "type":"FieldValue",
            "id":"100035"
        },
        {
            "type":"FieldValue",
            "id":"100036"
        },
        {
            "type":"FieldValue",
            "id":"100041"
        },
        {
            "type":"FieldValue",
            "id":"100043"
        },
        {
            "type":"FieldValue",
            "id":"100044"
        },
        {
            "type":"FieldValue",
            "id":"100045"
        },
        {
            "type":"FieldValue",
            "id":"100046"
        },
        {
            "type":"FieldValue",
            "id":"100047"
        },
        {
            "type":"FieldValue",
            "id":"100048"
        },
        {
            "type":"FieldValue",
            "id":"100049"
        },
        {
            "type":"FieldValue",
            "id":"100051"
        },
        {
            "type":"FieldValue",
            "id":"100065"
        },
        {
            "type":"FieldValue",
            "id":"100066"
        },
        {
            "type":"FieldValue",
            "id":"100068"
        },
        {
            "type":"FieldValue",
            "id":"100069"
        },
        {
            "type":"FieldValue",
            "id":"100072"
        },
        {
            "type":"FieldValue",
            "id":"100081"
        },
        {
            "type":"FieldValue",
            "id":"100171",
            "value":"norway.com"
        },
        {
            "type":"FieldValue",
            "id":"100172"
        },
        {
            "type":"FieldValue",
            "id":"100174"
        },
        {
            "type":"FieldValue",
            "id":"100175"
        },
        {
            "type":"FieldValue",
            "id":"100176"
        },
        {
            "type":"FieldValue",
            "id":"100177"
        },
        {
            "type":"FieldValue",
            "id":"100178"
        },
        {
            "type":"FieldValue",
            "id":"100179"
        },
        {
            "type":"FieldValue",
            "id":"100180"
        },
        {
            "type":"FieldValue",
            "id":"100184"
        },
        {
            "type":"FieldValue",
            "id":"100187"
        },
        {
            "type":"FieldValue",
            "id":"100188"
        },
        {
            "type":"FieldValue",
            "id":"100189",
            "value":"fortinbrasL88FJF"
        },
        {
            "type":"FieldValue",
            "id":"100190"
        },
        {
            "type":"FieldValue",
            "id":"100191"
        },
        {
            "type":"FieldValue",
            "id":"100192"
        },
        {
            "type":"FieldValue",
            "id":"100193"
        },
        {
            "type":"FieldValue",
            "id":"100194"
        },
        {
            "type":"FieldValue",
            "id":"100195"
        },
        {
            "type":"FieldValue",
            "id":"100197"
        }
    ],
    "isBounceback":"false",
    "isSubscribed":"true",
    "subscriptionDate":"1434050717"
}
			

Note:

For contact assets, the FieldValue id corresponds to the value received when making a GET request to the assets/contact/field/{id} endpoint.

Back to Top