Create a Group

This call makes a request to create a new group in the subscriber database.

A unique OID is created and returned. If supplied, the ExternalId must be unique within the subscriber database. The type of group created depends on the MDC type of the Attr field supplied. If not supplied, the system default group is created. Once created, the type of the group cannot be changed.

REST Example

For information about the Attr field, see Data Objects.

URL 
POST http://host:port/rsgateway/data/v3/group
Request XML 
<MtxRequestGroupCreate>
    <Name>XYZ Corp</Name>
    <Tier>corporation</Tier>
    <AdminArray>
        <MtxSubscriberSearchData>
            <ObjectId>0-1-5-1</ObjectId>
        </MtxSubscriberSearchData>
    </AdminArray>
    <Attr>
        <XYZgroupCorporateExtension />
    </Attr>
    <NotificationPreference>1</NotificationPreference>
    <GroupReAuthPreference>2</GroupReAuthPreference>
</MtxRequestGroupCreate>
Response 
<MtxResponseCreate>
    <ObjectId>0-1-5-10</ObjectId>
    <RouteId>1</RouteId>
    <Result>0</Result>
    <ResultText>OK</ResultText>
</MtxResponseCreate>