Contact Information

A lender's identifier for an object. After the object is successfully created, a lender can use ID or externalId identifiers to fetch the object.

To fetch the object using externalId you need to add ext- to the URL.

Note: Don't add ext- to the identifier value. For example: if the external identifier is ABCDE, then pass externalId=ACBCE and NOT ext-ABCDE when creating the object.

The type of contact.

phone and whatsApp should be provided in E.164 format.

email should be provided in aaa@bbb.com format.

address is the mailing address.

fbMessenger can be phone or email.

The contact label.

A person's mobile phone should be labeled as personal.

A person's home address should be labeled as home.

A servicemember's military unit or commander contact should be labeled as military.

Automated text messages (e.g. payment reminder) can only be sent to contactType=phone, label=personal and affiliation=self.

All contacts are associated with one borrower. Sometimes the contact represents information about the borrower person themself—e.g., the borrower's address. Sometimes the contact represents information about a person affiliated with the borrower.

self - denotes contact information about the borrower. All self contacts are considered to be first-party.

spouse, parent, guardian, executor, administrator, legal and otherRelative - are considered to be a third-party. Some regulations define these to be the consumer (aka the person) for purposes of debt collection efforts. This means that a debt collector may communicate about the debt with the consumer’s spouse, parent (if the consumer is a minor), guardian, executor, or administrator (or with the attorney of any of these people).

Automated text messages (e.g. payment reminder) can only be sent to contactType=phone, label=personal and affiliation=self.

Full name of a third-party contact. Only applicable for third-party contacts, such as spouse, parent, etc.

The value of a contact. This attribute should be used for all contact types except for address, which has dedicated attributes such as addressLine1, addressCity, etc. You should use either value or address attributes depending on the contact type. For example, +14155552671 for a contact type=phone. Or, john.smith@domain.com for a contact type=email. We'll validate the format based on the contact type.

The mailing address.

Identifies a contact as valid or invalid. A contact can become invalid for multiple reasons, such as wrong format, invalid email domain, etc. This attribute can be changed by you or by Peach. If no value is provided, we will assume valid=true.

Identifies a contact as verified or unverified. Contact can be verified via a verification code, verification link or a first-party outbound call. The value can be changed by you or by Peach. If no value is provided, we will assume verified=false.

Allows using a phone type contact for text messaging.

Signifies an individual authorized by the borrower to make purchases and changes against the account that is the subject of the collection efforts. This attribute is not applicable to contacts with affiliation self.

Designated an individual with power of attorney. This attribute can only be set by agents upon receiving appropriate documents from the borrower or their attorney. This attribute is not applicable to contacts with affiliation self.

A lender's identifier for an object. After the object is successfully created, a lender can use ID or externalId identifiers to fetch the object.

To fetch the object using externalId you need to add ext- to the URL.

Note: Don't add ext- to the identifier value. For example: if the external identifier is ABCDE, then pass externalId=ACBCE and NOT ext-ABCDE when creating the object.

The type of contact.

phone and whatsApp should be provided in E.164 format.

email should be provided in aaa@bbb.com format.

address is the mailing address.

fbMessenger can be phone or email.

The contact label.

A person's mobile phone should be labeled as personal.

A person's home address should be labeled as home.

A servicemember's military unit or commander contact should be labeled as military.

Automated text messages (e.g. payment reminder) can only be sent to contactType=phone, label=personal and affiliation=self.

All contacts are associated with one borrower. Sometimes the contact represents information about the borrower person themself—e.g., the borrower's address. Sometimes the contact represents information about a person affiliated with the borrower.

self - denotes contact information about the borrower. All self contacts are considered to be first-party.

spouse, parent, guardian, executor, administrator, legal and otherRelative - are considered to be a third-party. Some regulations define these to be the consumer (aka the person) for purposes of debt collection efforts. This means that a debt collector may communicate about the debt with the consumer’s spouse, parent (if the consumer is a minor), guardian, executor, or administrator (or with the attorney of any of these people).

Automated text messages (e.g. payment reminder) can only be sent to contactType=phone, label=personal and affiliation=self.

Full name of a third-party contact. Only applicable for third-party contacts, such as spouse, parent, etc.

The value of a contact. This attribute should be used for all contact types except for address, which has dedicated attributes such as addressLine1, addressCity, etc. You should use either value or address attributes depending on the contact type. For example, +14155552671 for a contact type=phone. Or, john.smith@domain.com for a contact type=email. We'll validate the format based on the contact type.

The mailing address.

Identifies a contact as valid or invalid. A contact can become invalid for multiple reasons, such as wrong format, invalid email domain, etc. This attribute can be changed by you or by Peach. If no value is provided, we will assume valid=true.

Identifies a contact as verified or unverified. Contact can be verified via a verification code, verification link or a first-party outbound call. The value can be changed by you or by Peach. If no value is provided, we will assume verified=false.

Allows using a phone type contact for text messaging.

Signifies an individual authorized by the borrower to make purchases and changes against the account that is the subject of the collection efforts. This attribute is not applicable to contacts with affiliation self.

Designated an individual with power of attorney. This attribute can only be set by agents upon receiving appropriate documents from the borrower or their attorney. This attribute is not applicable to contacts with affiliation self.

A lender's identifier for an object. After the object is successfully created, a lender can use ID or externalId identifiers to fetch the object.

To fetch the object using externalId you need to add ext- to the URL.

Note: Don't add ext- to the identifier value. For example: if the external identifier is ABCDE, then pass externalId=ACBCE and NOT ext-ABCDE when creating the object.

The type of contact.

phone and whatsApp should be provided in E.164 format.

email should be provided in aaa@bbb.com format.

address is the mailing address.

fbMessenger can be phone or email.

The contact label.

A person's mobile phone should be labeled as personal.

A person's home address should be labeled as home.

A servicemember's military unit or commander contact should be labeled as military.

Automated text messages (e.g. payment reminder) can only be sent to contactType=phone, label=personal and affiliation=self.

All contacts are associated with one borrower. Sometimes the contact represents information about the borrower person themself—e.g., the borrower's address. Sometimes the contact represents information about a person affiliated with the borrower.

self - denotes contact information about the borrower. All self contacts are considered to be first-party.

spouse, parent, guardian, executor, administrator, legal and otherRelative - are considered to be a third-party. Some regulations define these to be the consumer (aka the person) for purposes of debt collection efforts. This means that a debt collector may communicate about the debt with the consumer’s spouse, parent (if the consumer is a minor), guardian, executor, or administrator (or with the attorney of any of these people).

Automated text messages (e.g. payment reminder) can only be sent to contactType=phone, label=personal and affiliation=self.

Full name of a third-party contact. Only applicable for third-party contacts, such as spouse, parent, etc.

The value of a contact. This attribute should be used for all contact types except for address, which has dedicated attributes such as addressLine1, addressCity, etc. You should use either value or address attributes depending on the contact type. For example, +14155552671 for a contact type=phone. Or, john.smith@domain.com for a contact type=email. We'll validate the format based on the contact type.

The mailing address.

Identifies a contact as valid or invalid. A contact can become invalid for multiple reasons, such as wrong format, invalid email domain, etc. This attribute can be changed by you or by Peach. If no value is provided, we will assume valid=true.

Identifies a contact as verified or unverified. Contact can be verified via a verification code, verification link or a first-party outbound call. The value can be changed by you or by Peach. If no value is provided, we will assume verified=false.

Allows using a phone type contact for text messaging.

Signifies an individual authorized by the borrower to make purchases and changes against the account that is the subject of the collection efforts. This attribute is not applicable to contacts with affiliation self.

Designated an individual with power of attorney. This attribute can only be set by agents upon receiving appropriate documents from the borrower or their attorney. This attribute is not applicable to contacts with affiliation self.