ContactInfo Data Object - Customer Management

Defines the contact information for a user.

Syntax

XML

<xs:complexType name="ContactInfo" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Address" nillable="true" type="tns:Address" />
    <xs:element minOccurs="0" name="ContactByPhone" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="ContactByPostalMail" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="Email" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EmailFormat" nillable="true" type="tns:EmailFormat" />
    <xs:element minOccurs="0" name="Fax" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="HomePhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Mobile" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Phone1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Phone2" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "Address": {
    "BusinessName": "ValueHere",
    "City": "ValueHere",
    "CountryCode": "ValueHere",
    "Id": "LongValueHere",
    "Line1": "ValueHere",
    "Line2": "ValueHere",
    "Line3": "ValueHere",
    "Line4": "ValueHere",
    "PostalCode": "ValueHere",
    "StateOrProvince": "ValueHere",
    "TimeStamp": "ValueHere"
  },
  "ContactByPhone": "ValueHere",
  "ContactByPostalMail": "ValueHere",
  "Email": "ValueHere",
  "EmailFormat": "ValueHere",
  "Fax": "ValueHere",
  "HomePhone": "ValueHere",
  "Id": "LongValueHere",
  "Mobile": "ValueHere",
  "Phone1": "ValueHere",
  "Phone2": "ValueHere"
}

Elements

The ContactInfo object has the following elements: Address, ContactByPhone, ContactByPostalMail, Email, EmailFormat, Fax, HomePhone, Id, Mobile, Phone1, Phone2.

Element	Description	Data Type
Address	The address of the user. Note that the address BusinessName element is ignored if you try to set it for a user's contact information. The business name is only required for an AdvertiserAccount object. Add: Required Update: Optional. If no value is set for the update, this setting is not changed.	Address
ContactByPhone	A value that determines whether the user should be contacted by telephone. If true, the telephone number specified in the Phone1 element is used to contact the user. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed.	boolean
ContactByPostalMail	A value that determines whether the user should be contacted by postal mail. If true, correspondence is sent to the address specified in the Address element. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed.	boolean
Email	The email address is used to send the account activation notification to the user, and can contain a maximum of 100 characters. If the user should be contacted by email, set the EmailFormat element to a valid format value. The contact info email address may differ from the email address corresponding to the authenticated Microsoft Account. For more information, see the IsMigratedToMicrosoftAccount and UserName elements of the User. Add: Required Update: Optional. If no value is set for the update, this setting is not changed.	string
EmailFormat	The format of the body of an email message to use when correspondence is sent to the user (this does not apply to the activation notification email message). You must set this element if you want the user contacted via email. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed.	EmailFormat
Fax	The fax telephone number of the user. The telephone number can contain a maximum of 100 characters. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed.	string
HomePhone	The home telephone number of the user. The telephone number can contain a maximum of 100 characters. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed.	string
Id	The system-generated identifier of the object. Add: Read-only Update: Required	long
Mobile	The mobile telephone number of the user. The telephone number can contain a maximum of 100 characters. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed.	string
Phone1	The primary telephone number of the user. The telephone number can contain a maximum of 100 characters. Add: Required Update: Optional. If no value is set for the update, this setting is not changed.	string
Phone2	An alternate telephone number for the user. The telephone number can contain a maximum of 100 characters. Add: Optional Update: Optional. If no value is set for the update, this setting is not changed.	string

Requirements

Service: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Used By

User