---
title: "Create an empty contact list"
method: POST
path: "/add-list/"
tags: ["Lists"]
---

# Create an empty contact list

`POST /add-list/`

## Request

- Base URL: `http://api.smsfusion.com.au`
- URL: `http://api.smsfusion.com.au/add-list/`
- Auth: one of:
  - API key in query parameter `key`
  - HTTP basic

## Query parameters

- `key` string, required

## Response `200`

List created

- object
  - `success` boolean
  - `id` integer
  - `name` string
  - `unsublist` boolean

## Other responses

- `401`: FIELD_EMPTY - name missing or blank after trim
- `405`: Method not allowed - POST only

---

[API](https://skmtc.dev/smsfusion/apis/sms-fusion-api.md) · [All operations](https://skmtc.dev/smsfusion/apis/sms-fusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smsfusion/apis/sms-fusion-api/revisions/a88b2793a6e9?raw)