Social Profiles, E-mail Address, URLs, Phone Numbers, and Addresses

Social Profiles, E-mail Address, URLs, Phone Numbers, and Addresses are similar minor objects that contacts and companies have.

Though they are similar, they are separate types because we apply different restrictions in each case.

🚧
Note Length
E-mail address and URLs include a note field. This field has an arbitrary character limit of 500 characters, which should be more than generous for proper use. This limit may decrease in the future.

Social Profiles

Social profiles are links to social networks (like Facebook, Twitter, or LinkedIn) and instant messaging addresses (like Skype, AIM, Jabber).

Attribute Name	Type	Description	Attributes
`label`	`string`	A Label to give broad context to the social profile.	Read-Write Non-null
`service`	`string`	Social network name (e.g. Facebook, Twitter).	Read-Write Non-null
`username`	`string`		Read-Write Non-null

E-mail Addresses

Attribute Name	Type	Description	Attributes
`label`	`string`	A Label to give broad context to the e-mail address.	Read-Write Non-null
`address`	`string`	An email address.	Read-Write Non-null
`note`	`string`	Arbitrary additional notes related to the URL.	Read-Write Nullable

URLs

Attribute Name	Type	Description	Attributes
`label`	`string`	A Label to give broad context to the URL.	Read-Write Non-null
`url`	`string`	A URI string, which should be RFC 3986 compliant.	Read-Write Non-null
`note`	`string`	Arbitrary additional notes related to the URL.	Read-Write Nullable

Phone Numbers

Attribute Name	Type	Description	Attributes
`label`	`string`	A label to give broad context to the phone number (e.g. Home, Mobile).	Read-Write Non-null
`format`	`string`	Format of the phone number. Either `free-form` or `E.164`. E164 the preferred formatting. If the number can't be expressed in E.164 you use `free-form` and Daylite won't attempt to parse it.	Read-Write Nullable
`number`	`string`	The phone number as a string in the format specified in `format`.	Read-Write Non-null
`note`	`string`	Note about the phone number.	Read-Write Nullable

📘
Phone Number Formatting
Phone numbers are formatted with the E.164 standard.
Example: `<+><country code><subscriber number including area code>

Addresses

Attribute Name	Type	Description	Attributes
`label`	`string`	A label to give broad context to the address (e.g. Home, Work, Office).	Read-Write Non-null
`street`	`string`	Street number and name.	Read-Write Nullable
`city`	`string`	City/Town/Village/etc. name.	Read-Write Nullable
`state`	`string`	State/Province/County/etc. name.	Read-Write Nullable
`postal_code`	`string`	Postal/Zip Code.	Read-Write Nullable
`country`	`string`	Country name.	Read-Write Nullable
`note`	`string`	Additional details related to the address.	Read-Write Nullable

📘
Validation
Even though all address components are optional, a valid address requires at least one of street, city, state, postal_code, or country to be a non-empty string.