CreatePreference

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

1. Set the value of the isPreference key to true
2. Set the value of the CategoryId key to null

Creating a preference inside a category

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

Creating a preference category

1. Set the value of the isPreference key to false
2. 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);
}