Create List

INFO

Please note that due to the potential list sizes we are not returning the list content in API responses.

Authorization OAuth 2.0

This request requires OAuth 2.0 authorization.

Header Parameters

• • Authorization string required

    Bearer {ACCESS_TOKEN}

  • Content-Type string required

    application/json

  • Accept string required

    application/json

Request Parameters

• • list array required

    • string

      List item.

  • name string required

    The name of the list, max 255 characters.

  • type string required

    The type of list, one of: Affiliates Bank Routing Numbers Email Addresses Employer Names Telephone Numbers Social Security Numbers Last Four of Social Security Numbers ZIP Codes

Response Parameters

• • data object

    • id integer

      The ID of the list, can be used for future API requests to query list details or make updates.

    • name string

      The name of the list.

    • type string

      The type of list, one of: Affiliates Bank Routing Numbers Email Addresses Employer Names Telephone Numbers Social Security Numbers Last Four of Social Security Numbers ZIP Codes

    • deleted_at datetime

      Timestamp of when the list was archived, null if not archived.

    • created_at datetime

      Timestamp of when the list was created.

    • updated_at datetime

      Timestamp of when the list was last updated.

POST /api/v1/lead-management/lists

cURL

curl --request POST \
    "https://api.decisioncloud.me/api/v1/list-manager/lists" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
        \"list\": [
            \"{LIST_ITEM}\",
            \"{LIST_ITEM}\",
            \"{LIST_ITEM}\",
            \"{LIST_ITEM}\",
            // ...
        ],
        \"name\": \"{LIST_NAME}\",
        \"type\": \"{TYPE_NAME}\",
    }"

JavaScript

const url = new URL(
    "https://api.decisioncloud.me/api/v1/list-manager/lists"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "list": [
        "{LIST_ITEM}",
        "{LIST_ITEM}",
        "{LIST_ITEM}",
        "{LIST_ITEM}",
        // ...
    ],
    "name": "{LIST_NAME}",
    "type": "{TYPE_NAME}",
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

PHP

$client = new \GuzzleHttp\Client();
$response = $client->post(
    "https://api.decisioncloud.me/api/v1/list-manager/lists",
    [
        "headers" => [
            "Authorization" => "Bearer {ACCESS_TOKEN}",
            "Content-Type" => "application/json",
            "Accept" => "application/json",
        ],
        "json" => [
            "list" => [
                "{LIST_ITEM}",
                "{LIST_ITEM}",
                "{LIST_ITEM}",
                "{LIST_ITEM}",
                // ...
            ],
            "name" => "{LIST_NAME}",
            "type" => "{TYPE_NAME}",
        ],
    ],
);
$body = $response->getJson();
print_r($body);

Python

import requests
import json

url = "https://api.decisioncloud.me/api/v1/list-manager/lists"
payload = {
    "list": [
        "{LIST_ITEM}",
        "{LIST_ITEM}",
        "{LIST_ITEM}",
        "{LIST_ITEM}",
        // ...
    ],
    "name": "{LIST_NAME}",
    "type": "{TYPE_NAME}",
}

headers = {
  "Authorization": "Bearer {ACCESS_TOKEN}",
  "Content-Type": "application/json",
  "Accept": "application/json"
}

response = requests.request("POST", url, headers=headers, json=payload)
response.json()

200

{
    "data": {
        "id": 11,
        "name": "SSN List 1",
        "type": "Social Security Numbers",
        "deleted_at": null,
        "created_at": "2025-05-02T19:28:55.000000Z",
        "updated_at": "2025-05-02T22:01:12.000000Z"
    }
}

422

{
    "message": "The given data was invalid.",
    "errors": {
        "list": [
            [
                "There was an error on row 1. The SSN must be a valid Social Security Number in the format: XXX-XX-XXXX, XXX XX XXXX, or XXXXXXXXX.",
                "There was an error on row 1. The SSN is not a valid Social Security Number."
            ]
        ]
    }
}