---
title: "Create Distribution List"
method: POST
path: "/v0/distribution_list"
tags: ["Distribution Lists"]
---

# Create Distribution List

`POST /v0/distribution_list`

Create a new distribution list.

## Request body

- object — Arguments to the POST /distribution_list endpoint
  - `name` string, required — Name of the distribution list
  - `notes` string — Additional notes about the distribution list

## Response `200`

Single distribution list returned from GET /distribution_list/<uuid> endpoint

- object
  - `data` object, required — Single distribution list returned from GET /distribution_list/<uuid> endpoint
    - `distribution_list` object, required
      - `distribution_list_id` string, uuid, required — Unique identifier for the distribution list
      - `name` string, required — Name of the distribution list
      - `notes` string — Additional notes about the distribution list
      - `recipient_counts` object — Counts of recipients with email and phone numbers
        - `email_count` integer, required — Number of recipients with email addresses
        - `phone_count` integer, required — Number of recipients with phone numbers
      - `recipients` object[] — List of recipients (users and external contacts) in this distribution list
        - `email` string, email — Email address of the recipient
        - `is_external_contact` boolean, required — Whether this recipient is an external contact (true) or a user (false)
        - `name` string — Name of the recipient
        - `phone` string — Phone number of the recipient
        - `recipient_id` string, uuid, required — Unique identifier for the recipient
  - `error_message` string
  - `meta` object, required
    - `time` number
  - `skydio_error_code` integer, required
  - `status_code` integer, required

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/skydio/apis/skydio-cloud-api.md) · [All operations](https://skmtc.net/skydio/apis/skydio-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skydio/skydio-cloud-api/revisions/0f746b116483/schema)