Update Contact

Options

Identifier

Email (urlencoded) OR ID of the contact

Body

Values to update a contact

Request body which must comply to the following JSON Schema:

{
  "type" : "object",
  "properties" : {
    "attributes" : {
      "type" : "object",
      "additionalProperties" : {
        "oneOf" : [ {
          "type" : "number"
        }, {
          "type" : "string"
        }, {
          "type" : "boolean"
        }, {
          "type" : "array",
          "items" : {
            "type" : "string"
          }
        } ]
      },
      "description" : "Pass the set of attributes to be updated. **These attributes must be present in your account**. To update existing email address of a contact with the new one please pass EMAIL in attributes. For example, **{ \"EMAIL\":\"newemail@domain.com\", \"FNAME\":\"Ellie\", \"LNAME\":\"Roger\", \"COUNTRIES\":[\"India\",\"China\"]}**.\nThe attribute's parameter should be passed in capital letter while updating a contact. Values that don't match the attribute type (e.g. text or string in a date attribute) will be ignored. Keep in mind transactional attributes can be updated the same way as normal attributes. Mobile Number in **SMS** field should be passed with proper country code. For example: **{\"SMS\":\"+91xxxxxxxxxx\"} or {\"SMS\":\"0091xxxxxxxxxx\"}**\n",
      "example" : {
        "EMAIL" : "newemail@domain.com",
        "FNAME" : "Ellie",
        "LNAME" : "Roger",
        "COUNTRIES" : [ "India", "China" ]
      }
    },
    "ext_id" : {
      "type" : "string",
      "description" : "Pass your own Id to update ext_id of a contact.",
      "example" : "updateExternalId"
    },
    "emailBlacklisted" : {
      "type" : "boolean",
      "description" : "Set/unset this field to blacklist/allow the contact for emails (emailBlacklisted = true)",
      "example" : false
    },
    "smsBlacklisted" : {
      "type" : "boolean",
      "description" : "Set/unset this field to blacklist/allow the contact for SMS (smsBlacklisted = true)",
      "example" : true
    },
    "listIds" : {
      "type" : "array",
      "description" : "Ids of the lists to add the contact to",
      "items" : {
        "type" : "integer",
        "description" : "Id of the list to add the contact to",
        "format" : "int64",
        "example" : 65
      }
    },
    "unlinkListIds" : {
      "type" : "array",
      "description" : "Ids of the lists to remove the contact from",
      "items" : {
        "type" : "integer",
        "description" : "Id of the list to remove the contact from",
        "format" : "int64",
        "example" : 36
      }
    },
    "smtpBlacklistSender" : {
      "type" : "array",
      "description" : "transactional email forbidden sender for contact. Use only for email Contact",
      "items" : {
        "type" : "string",
        "format" : "email"
      }
    }
  }
}

Result Format

Specify how the response should be mapped to the table output. The following formats are available:

Raw Response: Returns the raw response in a single row with the following columns:

• status: HTTP status code

Views

This node has no views

Workflows

• No workflows found

Links

• No links available

Developers