Edit

ContactInfo Data Object - Customer Management

  • Article

Defines the contact information for a user.

Syntax

<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>

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