Service: zimbraAdmin
Namespace: "urn:zimbraAdmin"
CreateDistributionList SOAP Command

Create a distribution list
Notes:

Access: domain admin sufficient

Authorization token required true
Admin Authorization token required true

CreateDistributionListRequest

    <CreateDistributionListRequest name="{new-dl-name}" [dynamic="(0|1)"]> ## CreateDistributionListRequest
        (<a n="{key}" /> ## Attr)*
    </CreateDistributionListRequest>

The following table describes elements and attributes you can define within a <CreateDistributionListRequest> element:

XPath Required / Optional Description
@name Required (only 1) Type:String
Name for distribution list
@dynamic Optional (0 or 1) Type:0|1
If 1 (true) then create a dynamic distribution list
/a Optional (0 or more) Attributes
/a@n Required (only 1) Type:String
Key

CreateDistributionListResponse

    <CreateDistributionListResponse> ## CreateDistributionListResponse
        <dl [dynamic="{dl-is-dynamic} (0|1)"] name="{name}" id="{id}"> ## DistributionListInfo
            (<dlm>{members} (String)</dlm>)*
            <owners>
                (<owner [type="{grantee-type} (usr|grp|egp|all|dom|edom|gst|key|pub|email)"] id="{grantee-id}"
                            name="{grantee-name}" /> ## GranteeInfo)*
            </owners>
            (<a n="{key}" /> ## Attr)*
        </dl>
    </CreateDistributionListResponse>

The following table describes elements and attributes you can define within a <CreateDistributionListResponse> element:

XPath Required / Optional Description
/dl Required (only 1) Information about the newly created distribution list
/dl@dynamic Optional (0 or 1) Type:0|1
Flags whether this is a dynamic distribution list or not
/dl@name Required (only 1) Type:String
Name
/dl@id Required (only 1) Type:String
ID
/dl/dlm Optional (0 or more) Type:{members} (String)
dl-members
/dl/owners Required (only 1)
/dl/owners/owner Optional (0 or more)
/dl/owners/owner@type Optional (0 or 1) Type:usr|grp|egp|all|dom|edom|gst|key|pub|email
Grantee type
/dl/owners/owner@id Required (only 1) Type:String
Grantee ID
/dl/owners/owner@name Required (only 1) Type:String
Grantee name
/dl/a Optional (0 or more) Attributes
/dl/a@n Required (only 1) Type:String
Key