This defines the contact (the end user) for the account. There are two types of contacts that need to be created as part of the customer account creation: the Bill-To and the Sold-To contacts. Contact provides the attributes needed to create these.
This object is used in the create, query, update, and delete calls.
In addition to the following fields, zObject contributes additional fields. For information on the field types, see Field Types.
| Name | Required? | Type | Allowed Values | Description |
|---|---|---|---|---|
| AccountId | No for the subscribe call; Yes otherwise | zns: ID | A valid account ID | This is the Zuora system account ID that this contact is associated with. |
| Address1 | Yes if a “Bill to” contact is being specified; No otherwise | string | 255 characters | The first line of the contact's address. This could be, for example, a street address or a PO box number. |
| Address2 | No | string | 255 characters | The second line of the contact's address. |
| City | Yes if a “Bill to” contact is being specified; No otherwise | string | 40 characters | The city portion of the contact's address. |
| Country | Yes if a “Bill to” contact is being specified; No otherwise | string | 40 characters | The country portion of the contact's address. Country names must be spelled in full; we've provided a list of supported country names. |
| CreatedDate | Yes | dateTime | This field is not editable. | The Zuora system automatically generates this date when the contact is created. |
| Fax | No | string | 40 characters | The contact's fax number. |
| FirstName | Yes | string | 100 characters | The contact's first name, given name, or personal name. |
| HomePhone | No | string | 40 characters | The contact's home phone number. |
| LastName | Yes | string | 100 characters | The contact's last name, surname, or family name. |
| MobilePhone | No | string | 40 characters | The contact's mobile phone number. |
| NickName | No | string | 100 characters | A nickname for the contact. |
| OtherPhone | No | string | 40 characters | Another phone number for the contact. |
| OtherPhoneType | No | string | Work, Mobile, Home, or Other | The type of phone number (home, mobile, office, etc.) for the contact's other phone number. |
| PersonalEmail | No | string | 80 characters | The contact's personal email address. |
| PostalCode | Yes if a “Bill to” contact is being specified; No otherwise | string | 20 characters | The postal code for the contact's address. |
| State | Yes if a “Bill to” contact is being specified; No otherwise | string | 40 characters | The state or province portion of the contact's address. State names must be spelled in full; we've provided a list of supported state names. |
| UpdatedDate | Yes | dateTime | This field is not editable | The Zuora system automatically generates this date when the contact is modified. |
| WorkEmail | Yes if a “Bill to” contact is being specified; No otherwise | string | 80 characters | The contact's work email address. |
| WorkPhone | No | string | 40 characters | The contact's work telephone number. |