Append Contacts To List

This endpoint allows you to add contacts to a specific list identified by 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 addContactstToList(listId) {
      const list = await client.appendContactsToList(listId, {
            fields: ["first_name", "email", "phone"],
            values: [
                ["hunter", "[e-mail]", "[phone]"],
                ["john", "[e-mail]", "[phone]"]
            ]
      });

      console.log(list);
};

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

---

API Endpoint

POST

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

---

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 id of the list to be updated. This parameter is required.

Required Body Parameters

• fields (array of strings): An array specifying the fields that will be populated for each contact (e.g., ["record_id"]). This parameter is required.

• values (array of arrays): An array of arrays. Inner arrays contain the values associated with the field types you specify in the fields attribute. You may pass in up to 10,000 contacts per API call. This parameter is required.

Optional Body Parameters

• region (string): Array of strings that define the data types being passed in the values attribute. It is acceptable to have repeat field types specified if your contacts have multiple phone numbers, pass in the value of "phone" multiple times in this array. Possible field types are: record_id, first_name, last_name, company, email, phone, address1, address2, city, state, postal, country, custom1, custom2, custom3, custom4, custom5.

Append contacts to a list

post

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

Body

application/json

fieldsstring[]Required

Array of strings that define the data types being passed in the Values attribute. It is acceptable to have repeat field types specified if your contacts have multiple phone numbers, pass in the value of “phone” multiple times in this array. Possible field types are: record_id, first_name, last_name, company, email, phone, address1, address2, city, state, postal, country, custom1, custom2, custom3, custom4, custom5. (Required)

regionstringOptional

The ISO country code to use when converting your phone number values to E.164 format. If yourphone numbers are already formatted in E.164 then the region attribute is ignored. Defaults to US.

Responses

200

Returns accepted_count and rejected details.

application/json

post

/list/{list_id}/contacts

HTTPcURLJavaScriptPython

POST /v1/list/{list_id}/contacts HTTP/1.1
Host: api.dropcowboy.com
x-team-id / x-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "fields": [
    "text"
  ],
  "values": [
    []
  ],
  "region": "text"
}

200

Returns accepted_count and rejected details.

{
  "accepted_count": 1,
  "rejected": [
    {
      "index": 1,
      "reason": "text"
    }
  ]
}

---

Example Response

The response will be in JSON format and will include the following fields:

• accepted_count (integer): The number of contacts appended to the list.

• rejected (array): An array of objects containing the index of the rejected contact from the value array that you passed to the api and the reason that contact was rejected, where each object contains:

  1. index (integer): The index of the rejected contact in the original request.

  2. reason (string): The reason for rejection (if applicable).