WSMailUpImport.CreateGroup

Method parameters:

CreateGroup(int idList, int listGUID, string newGroupName)

Creates a new group for the specified list.

idList: list identifier
listGuid: GUID of the list
newGroupName: name of the group to be created

The returned value is the ID of the created group.

If a group with the same name already exists in the list, then no new group is created and the ID of the existing group is returned.

Maximum allowed lenght for Group names is 50 characters, if you specify more than 50 characters the actual Group name will be truncated by MailUp

Sample CreateGroup response

<mailupMessage>
  <mailupBody>
    <ReturnCode>12</ReturnCode>
  </mailupBody>
</mailupMessage>

Error codes

Error code	Description

Error code	Description
-300	unrecognized error
-301	the list has not been specified
-302	the group name has not been specified
-303	the group already exists

Ruby Example

# Refer to https://mailup.atlassian.net/wiki/display/mailupapi/MailUp+RubyGem for gem information.
require 'mailup'
m = MailUp::Import.new('username', 'password', 'console_url')
m.create_group(:idList => 123456, :listGuid => 'abc123', :newGroupName => 'Sample Group')
# => <?xml version=\"1.0\" encoding=\"windows-1252\" ?><mailupMessage><mailupBody><ReturnCode>12</ReturnCode></mailupBody></mailupMessage>