Customer Email Object

The customer email object defines the email messages and preferences a customer should receive. Messages include "Credit Card Expiry Notices", "Invoice Overdue Notices" and others.

Currently, there are preference entities for the following emailTypes

  • InvoicePost
  • PaymentReceived
  • InvoiceOverdue
  • PasswordReset
  • PaymentFailed
  • CustomerActivation
  • SubscriptionActivation
  • SubscriptionCancellation
  • CustomerCredentialCreate
  • CustomerCredentialPasswordReset
  • CustomerSuspend
  • PaymentMethodUpdate
  • CreditCardExpiry
  • StatementNotification
  • UpcomingBillingNotification
  • Refund
  • PendingExpiryRenewalNotice

Additional preference entities may be added in the future so when editing the email preferences via the API it is suggested to always perform a GET to retrieve the full email preferences list and to then modify the data in that list and PUT that list to perform the edit action. This ensures the PUT action includes all the required preference entities.

Customer Email Preferences Fields

customerIdIntegerThis is the Fusebill ID of the customer to whom these preferences apply.

[Read Only]
preferencesList of Objects (definition below)This is the list of Preference entities.

Preferences Object Fields

enabledStringSpecify whether or not the specified email notification is enabled. Values should be one of: "true", "false" or NULL (account default)
accountDefaultBooleanThe default preference across the account. To be used if enabled is NULL.

[Read Only]
emailTypeEnum:{InvoicePost, PaymentReceived, InvoiceOverdue, PasswordReset, PaymentFailed, CustomerActivation, SubscriptionActivation, SubscriptionCancellation, CustomerCredentialCreate, CustomerCredentialPasswordReset, CustomerSuspend, PaymentMethodUpdate, CreditCardExpiry, StatementNotification, UpcomingBillingNotification, Refund, PendingExpiryRenewalNotice}Used to specify which email notification. Valid values are any of the following:

[Read Only]
emailCategoryStringDescribes the general category of the email. Mostly for internal use.

[Read Only]