Delete Contact List

This endpoint allows users to delete a specific list by providing the unique identifier list_id.

---

Using the SDK

// Download the helper library from https://www.npmjs.com/package/dropcowboy
const { DropCowboy } = require("dropcowboy"); // Or, for ESM: import { DropCowboy } from "dropcowboy";

// Find your Team ID and Secret at dropcowboy.com/appv1/#/api
// and set the environment variables.
const teamId = process.env.DROPCOWBOY_TEAM_ID;
const secret = process.env.DROPCOWBOY_SECRET;
const client = new DropCowboy({ teamId: teamId, secret: secret });

async function deleteList(listId) {
      const list = await client.deleteContactList(listId);

      console.log(list);
};

deleteList("00000000-0000-0000-0000-000000000000");

---

API Endpoint

DELETE

https://api.dropcowboy.com/v1/list/{list_id}

---

Example Request

Required Headers

• x-team-id - Your Team ID from API settings

• x-secret - Your Secret Key from API settings

Required URL Path Parameters

• list_id (string) - The unique identifier of the list that you wish to delete. This parameter is required.

Delete contact list

delete

Authorizations

teamSecretAuth

x-team-id / x-secretstringRequired

Requires two headers: x-team-id and x-secret. Both must be sent with each request.

Path parameters

list_idstringRequired

Responses

200

200 OK on success

No content

delete

/list/{list_id}

HTTPcURLJavaScriptPython

DELETE /v1/list/{list_id} HTTP/1.1
Host: api.dropcowboy.com
x-team-id / x-secret: YOUR_API_KEY
Accept: */*

200

200 OK on success

No content

---

Example Response

The response will have a 200 OK status code and a payload with the deleted list_id on successful deletion.

{
    "list_id": "00000000-0000-0000-0000-000000000000"
}