This method creates either a new preference or a new preference category.

Preferences that are inside the same category must have unique private names
Uncategorised preferences must have unique private names
All categories must have unique private names
Preferences and categories can have the same public names

Creating a preference outside of a category

Set the value of the isPreference key to true
Set the value of the CategoryId key to null

Creating a preference inside a category

Set the value of the isPreference key to true
Set the value of the CategoryId key to the ID of an existing category

Creating a preference category

Set the value of the isPreference key to false
Set the value of the CategoryId key to a unique integer

SOAP action: http://apiconnector.com/v2/ApiService/CreatePreference

📘
Input and output parameters
Input parameters

PublicName - required; string

PrivateName - string (Default: PublicName string)

IsPreference - boolean (Default: false)

Order - string (int, 'top', 'bottom')

IsPublic - boolean (Default: false)

CategoryID - int (Default for preferences: 0. Default for preference categories: null)

Output parameters

ID - integer

PublicName - string

PrivateName - string

IsPreference - boolean

Order - string (int, 'top', 'bottom')

IsPublic - boolean

CategoryID - integer

PreferenceCount - integer

Created - DateTime

LastModified - DateTime

Example

using (var client = new ApiServiceClient())
{
  client.ClientCredentials.UserName.UserName = "username";
  client.ClientCredentials.UserName.Password = "password";

  var preference = new ApiPreference {
      PublicName: "Preferred contact method",
      PrivateName: "Preferred contact method",
      IsPreference: false,
      Order: "top",
      IsPublic: false,
      CategoryId: null
    }
  var createdContact = client.CreatePreference(preference);
}