post https://api.shift.io/v3/distributionlists
Creates a new distribution list
When you create a new distribution list, you must provide a name, accessType, and recipients as body parameters. The accessType parameter determines the list’s “sharing” setting; the three sharing options are:
- Private (the list is only accessible to the list creator)
- Account (the list can be used by any workspace user)
- User_List (the list can be used by select workspace users only). If you select User_List, then you must specify those workspace users by using the authorizedUserIds parameter.
Here is an example request:
{
"name": "My Distribution List",
"accessType": "user_list",
"recipients": [
{"email": "[email protected]"},
{"email": "[email protected]"},
{"email": "[email protected]"}
],
"authorizedUserIds": [
"11111111-1111-1111-1111-111111111111",
"22222222-2222-2222-2222-222222222222",
"33333333-3333-3333-3333-333333333333"
]
}
Upon creating a distribution list, a 200 code and the distribution list id are returned.