Official Drop Cowboy Postman Collection: APIs, docs, and resources for voice & text messaging.
\nJust fork the collection to your workspace to immediately begin testing our API endpoints. You'll find everything you need to start building, including ready-to-use requests, examples, and detailed documentation.
\nEmail: info@dropcowboy.com
\nWebsite: Drop Cowboy Website
\nLinkedIn: @RinglessVoicemail
\nFacebook: @DropCowboy
\nGitHub: @Drop-Cowboy
\nX: @DropCowboy
\nrecording_id)curl --header \"Content-Type: application/json\" \n--data '{\"team_id\":\"\",\"secret\":\"\",\"brand_id\":\"00000000-0000-0000-0000-000000000000\",\"recording_id\":\"00000000-0000-0000-0000-000000000000\",\"phone_number\":\"+15552223333\",\"forwarding_number\":\"+15557778888\",\"foreign_id\":\"\"}' \nhttps://api.dropcowboy.com/v1/rvm\n\nvoice_id+tts_body)curl --header \"Content-Type: application/json\" \\\n--data '{\"team_id\":\"<your team_id>\",\"secret\":\"<your secret>\",\"brand_id\":\"00000000-0000-0000-0000-000000000000\",\"voice_id\":\"00000000-0000-0000-0000-000000000000\",\"tts_body\":\"Hello Jane, this is John from Brand calling about...\",\"phone_number\":\"+15552223333\",\"forwarding_number\":\"+15557778888\",\"foreign_id\":\"<your system value>\"}' \\\nhttps://api.dropcowboy.com/v1/rvm\n\naudio_url)curl --header \"Content-Type: application/json\" \\\n--data '{\"team_id\":\"<your team_id>\",\"secret\":\"<your secret>\",\"brand_id\":\"00000000-0000-0000-0000-000000000000\",\"audio_url\":\"https://example.com/your-file.mp3\",\"audio_type\":\"mp3\",\"phone_number\":\"+15552223333\",\"forwarding_number\":\"+15557778888\",\"foreign_id\":\"<your system value>\"}' \\\nhttps://api.dropcowboy.com/v1/rvm\n\n{\n \"drop_id\": \"5c8eb7940a057a4ab0823e1a\",\n \"phone_number\": \"+15552224444\",\n \"attempt_date\": \"2019-03-17T21:10:26.000Z\",\n \"status\": \"success\",\n \"reason\": \"\",\n \"dnc\": false,\n \"product_cost\": 0.099,\n \"compliance_fee\": 0.0029,\n \"tts_fee\": 0.03,\n \"network\": {\n \"name\": \"Verizon Wireless:6006 - SVR/2\",\n \"type\": \"wireless\"\n },\n \"foreign_id\": \"<your system value>\"\n}\n\n{\n \"drop_id\": \"5c8ee427a8d9ef4758bfaca5\",\n \"phone_number\": \"+15552224444\",\n \"attempt_date\": \"2019-03-18T00:20:26.000Z\",\n \"status\": \"failure\",\n \"reason\": \"VoiceMail NotDetected\",\n \"dnc\": false,\n \"product_cost\": 0,\n \"compliance_fee\": 0.0029,\n \"tts_fee\": 0.03,\n \"network\": {\n \"name\": \"Verizon Wireless:6006 - SVR/2\",\n \"type\": \"wireless\"\n },\n \"foreign_id\": \"<your system value>\"\n}\n\nDirectly integrate ringless voicemail delivery into your software.
Successful deliveries are deducted from your account balance based on the rate dictated by your monthly subscription plan.
Invoke the Drop Cowboy API from your application by sending an HTTP POST containing a JSON document with the attributes listed below.
\nOnce delivery is attempted, you will receive a callback containing the delivery status to the webhook specified in your API settings.
\n","_postman_id":"3aba240c-91ff-44ec-a238-cc4da0faf65e"},{"name":"SMS (Text Messages)","item":[{"name":"Send SMS Text Messages","event":[{"listen":"test","script":{"id":"6e6a2b49-7f1a-43d6-bed2-dac826326263","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"0dc93340-26a2-4a0c-a0ab-4b40880e6bf7","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"team_id\": \"curl --header \"Content-Type: application/json\"\n--data \"{\"team_id\": \"<your team_id>\", \"secret\": \"<your secret>\", \"brand_id\": \"00000000-0000-0000-0000-000000000000\", \"sms_body\": \"Hello world!\", \"opt_in\": true, \"phone_number\": \"+15552223333\", \"caller_id\":\"+15557778888\", \"foreign_id\": \"<your system value>\"}\"\nhttps://api.dropcowboy.com/v1/sms\n\n{\n \"drop_id\": \"5c8eb7940a057a4ab0823e1a\",\n \"phone_number\": \"+15552224444\",\n \"attempt_date\": \"2019-03-17T21:10:26.000Z\",\n \"status\": \"success\",\n \"reason\": \"\",\n \"dnc\": false,\n \"spam\": false,\n \"product_cost\": 0.099,\n \"compliance_fee\": 0.0029,\n \"tts_fee\": 0,\n \"network\": {\n \"name\": \"Verizon Wireless:6006 - SVR/2\",\n \"type\": \"wireless\"\n },\n \"foreign_id\": \"<your system's id>\"\n}\n\n{\n \"drop_id\": \"5c8ee427a8d9ef4758bfaca5\",\n \"phone_number\": \"+15552224444\",\n \"attempt_date\": \"2019-03-18T00:20:26.000Z\",\n \"status\": \"failure\",\n \"reason\": \"Invalid message\",\n \"dnc\": false,\n \"spam\": false,\n \"product_cost\": 0,\n \"compliance_fee\": 0.0029,\n \"tts_fee\": 0,\n \"network\": {\n \"name\": \"Verizon Wireless:6006 - SVR/2\",\n \"type\": \"wireless\"\n },\n \"foreign_id\": \"<your system's id>\"\n}\n\nInvoke our api from your application by sending an HTTP POST containing a json document with the attributes listed below. Once delivery is attempted, you will receive a callback containing the delivery status to the webhook you specified in your api settings.
\n","_postman_id":"773b099c-0311-4568-a3dc-88f5f3f98d7a"},{"name":"Recordings","item":[{"name":"Listing Recordings (Legacy)","id":"8733981c-d12c-440c-a19f-aa664acbaefc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-team-id","value":"","description":"REQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"url":"https://api.dropcowboy.com/v1/media","description":"This endpoint retrieves a list of media items from the server.
\n*Note: This route is legacy and will no longer receive updates. Please use the current route (/recording) for all future implementations.
Method: GET
\nEndpoint: https://api.dropcowboy.com/v1/media
The response is a JSON array containing media objects with the following structure:
\nmedia_id (string): A unique identifier for the media item.
\nname (string): The name of the media item.
\ncreated_at (integer): A timestamp indicating when the media item was created.
\napi_allowed (boolean): A flag indicating whether the API allows access to this media item.
\n[\n {\n \"media_id\": \"\",\n \"name\": \"\",\n \"created_at\": 0,\n \"api_allowed\": true\n }\n]\n\nREQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"url":"https://api.dropcowboy.com/v1/recording","description":"This endpoint retrieves a list of recording items from the server.
\nMethod: GET
\nEndpoint: https://api.dropcowboy.com/v1/recording
The response is a JSON array containing media objects with the following structure:
\nmedia_id (string): A unique identifier for the media item.
\nname (string): The name of the media item.
\ncreated_at (integer): A timestamp indicating when the media item was created.
\napi_allowed (boolean): A flag indicating whether the API allows access to this media item.
\n[\n {\n \"media_id\": \"\",\n \"name\": \"\",\n \"created_at\": 0,\n \"api_allowed\": true\n }\n]\n\nFilter results by whether recordings are API-approved
\n","type":"text/plain"},"key":"api_allowed","value":""}],"variable":[]}},"response":[{"id":"a36ebe4a-7933-40d7-bc78-a13e6e56fc77","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-team-id","value":"","type":"text"},{"key":"x-secret","value":"","type":"text"}],"url":{"raw":"https://api.dropcowboy.com/v1/recording","host":["https://api.dropcowboy.com/v1"],"path":["recording"],"query":[{"key":"api_allowed","value":null,"description":"Filter results by whether recordings are API-approved","type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"media_id\": \"abcace9b-471c-4c77-8c07-0bcba83f9abc\",\n \"name\": \"My Audio Recording\",\n \"created_at\": 1719344977000,\n \"api_allowed\": false\n },\n {\n \"media_id\": \"ba2ace9b-471c-4c77-8c07-0bcba83f9xyz\",\n \"name\": \"Another Recording\",\n \"created_at\": 1719344977000,\n \"api_allowed\": true\n }\n]"}],"_postman_id":"37cd832a-ba83-4227-8b2c-8d5e7d877eb2"}],"id":"95b726ba-ff2e-4996-a5fa-68572982bbeb","description":"Invoke our recordings api from your application by sending an HTTP GET containing with the attributes listed below.
\n","_postman_id":"95b726ba-ff2e-4996-a5fa-68572982bbeb"},{"name":"Brands","item":[{"name":"Listing Brands","id":"fc19e829-8b4a-431e-908a-6d00f34b8e57","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-team-id","value":"","description":"REQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"url":"https://api.dropcowboy.com/v1/brand","description":"GET https://api.dropcowboy.com/v1/brandThis endpoint retrieves a list of brands from the server. It is used to obtain information about various brands, including their identifiers and associated company details.
\nThis endpoint does not require any input parameters. The request is made using the HTTP GET method, and it is expected to return a collection of brand information.
\nThe response will be in JSON format and contains an array of objects, where each object represents a brand. The structure of each brand object includes the following fields:
\nbrand_id: (string) A unique identifier for the brand.
\ncompany_name: (string) The name of the company associated with the brand.
\ndba_name: (string) The \"Doing Business As\" name for the brand, if applicable.
\nregistered: (boolean) A boolean reflecting if the brand has been registered or not.
\napi_allowed: (boolean) A boolean reflecting if the brand has been approved to be used for api access or not.
\n[\n {\n \"brand_id\": \"\",\n \"company_name\": \"\",\n \"dba_name\": \"\",\n \"registered\": true,\n \"api_allowed\": true\n }\n]\n\nInvoke our brand api from your application by sending an HTTP GET containing with the attributes listed.
\n","_postman_id":"400c4f8f-eff7-4965-8ced-e7420e06cf88"},{"name":"Number Pools","item":[{"name":"Listing Number Pools","id":"40451e3c-8e7c-4efa-8520-5bb559050c11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"x-team-id","value":"","description":"REQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"url":"https://api.dropcowboy.com/v1/pool","description":"This endpoint retrieves a list of pools available in the system.
\nhttps://api.dropcowboy.com/v1/poolThe response is returned in JSON format and contains an array of pool objects. Each object includes the following fields:
\npool_id: A unique identifier for the pool (string).
\nbrand_id: The identifier for the brand associated with the pool (string).
\nname: The name of the pool (string).
\nservice_type: The type of service provided by the pool (string).
\nnumber_count: The count of numbers associated with the pool (integer).
\n[\n {\n \"pool_id\": \"\",\n \"brand_id\": \"\",\n \"name\": \"\",\n \"service_type\": \"\",\n \"number_count\": 0\n }\n]\n\nInvoke our number pool api from your application by sending an HTTP GET containing with the attributes listed below.
\n","_postman_id":"737ce7de-af08-4edf-a1c2-fb1c3abf543c"},{"name":"Contact Lists","item":[{"name":"Create Contact List","id":"1aff7736-af58-4be8-8b7a-d763fe1ec647","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-team-id","value":"","description":"REQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"list_name\": \"My List Name\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dropcowboy.com/v1/list","description":"This endpoint allows users to create a new list by providing a name for the list.
\nMethod: POST
\nEndpoint: https://api.dropcowboy.com/v1/list
Request Body (JSON):
\nlist_name (string): The name of the list to be created. This parameter is required.Example Request:
\n{\n \"list_name\": \"My List Name\"\n}\n\nUpon successful creation of the list, the API will return a JSON object containing the following fields:
\nlist_id (string): The UUID of the list. Use this value in other calls to the contact list api endpoints. It is safe to cache this value client side in your app.
list_name (string): A string containing the name of the list.
created_at (integer): Milliseconds since epoch of when the list was created.
Example Response:
\n{\n \"list_id\": \"\",\n \"list_name\": \"\",\n \"created_at\": 0\n}\n\nlist_name is unique to avoid conflicts with existing lists.REQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"list_name\": \"My Updated List Name\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dropcowboy.com/v1/list/{{list_id}}","description":"This endpoint allows you to update the details of a specific list identified by list_id. By sending a POST request to https://api.dropcowboy.com/v1/list/{{list_id}}, you can modify the name of an existing list.
Method: POST
\nURL: https://api.dropcowboy.com/v1/list/{{list_id}}
Request Body: The body of the request should be in JSON format and must include the following parameter:
\nlist_name (string): The new name for the list.{\n \"list_name\": \"My Updated List Name\"\n}\n\nUpon a successful update, the server will respond with a confirmation message indicating that the list has been updated.
\nREQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"region\": \"US\",\r\n \"fields\": [\r\n \"record_id\",\r\n \"first_name\",\r\n \"last_name\",\r\n \"company\",\r\n \"email\",\r\n \"phone\",\r\n \"phone\",\r\n \"phone\",\r\n \"address1\",\r\n \"address2\",\r\n \"city\",\r\n \"state\",\r\n \"postal\",\r\n \"country\",\r\n \"custom1\",\r\n \"custom2\",\r\n \"custom3\",\r\n \"custom4\",\r\n \"custom5\"\r\n ],\r\n \"values\": [\r\n [\r\n \"ExternalID123\",\r\n \"bob\",\r\n \"doe\",\r\n \"bobs company\",\r\n \"bob@example.com\",\r\n \"555-111-1111\",\r\n \"(555) 222-2222\",\r\n \"+15553334444\",\r\n \"123 Very Long Name St.\",\r\n \"Apartment 12345\",\r\n \"Phoenix\",\r\n \"AZ\",\r\n \"85020\",\r\n \"US\",\r\n \"Under $500,000\",\r\n \"Green\",\r\n \"3 Kids\",\r\n \"1 Dog\",\r\n \"Next 6 Months\"\r\n ]\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dropcowboy.com/v1/list/{{list_id}}/contacts","description":"This endpoint allows you to add contacts to a specific list identified by list_id. The request requires a JSON payload that specifies the region, the fields to be populated, and the values for those fields.
The request body must be in JSON format and include the following parameters:
\nregion (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.
fields (array of strings): An array specifying the fields that will be populated for each contact (e.g., [\"record_id\"]).
\nvalues (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.
\nExample Request Body:
\n{\n \"region\": \"US\",\n \"fields\": [\"record_id\"],\n \"values\": [[\"ExternalID123\"]]\n}\n\nThe response will be in JSON format and will include the following fields:
\naccepted_count (integer): The number of contacts appended to the list.
\nrejected (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:
\nindex (integer): The index of the rejected contact in the original request.
\nreason (string): The reason for rejection (if applicable).
\nExample Response:
\n{\n \"accepted_count\": 0,\n \"rejected\": [\n {\n \"index\": 0,\n \"reason\": \"\"\n }\n ]\n}\n\nREQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"url":"https://api.dropcowboy.com/v1/list/{{list_id}}","description":"This endpoint retrieves the details of a specific list identified by the list_id.
Method: GET
\nURL: https://api.dropcowboy.com/v1/list/{{list_id}}
Path Parameters:
\nlist_id (string): Is the UUID value returned in the api results when creating a list or getting a list from the /list endpoint.On successful retrieval, the response will contain the following structure:
\nlist_id (string): The UUID of the list. Use this value in other calls to the contact list api endpoints. It is safe to cache this value client side in your app.
list_name (string): A string containing the name of the list.
created_at (integer): Milliseconds since epoch of when the list was created.
contact_count (integer): The total number of contacts in the list.
{\n \"list_id\": \"\",\n \"list_name\": \"\",\n \"created_at\": 0,\n \"contact_count\": 0\n}\n\nREQUIRED | The team_id assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"},{"key":"x-secret","value":"","description":"REQUIRED | The secret assigned to your Drop Cowboy account. This value is found by logging into Drop Cowboy and visiting the My Account -> API page.
\n","type":"text"}],"url":"https://api.dropcowboy.com/v1/list/{{list_id}}","description":"This endpoint allows users to delete a specific list by providing the unique identifier of the list.
\nMethod: DELETE
\nURL: https://api.dropcowboy.com/v1/list/{{list_id}}
Path Parameter:
\nlist_id (string): The unique identifier of the list that you wish to delete.Upon successful deletion, the server will respond with a confirmation message indicating that the item has been removed. The expected response will typically include:
\nA status code indicating the result of the operation (e.g., 200 for a successful deletion).
An object with the list_id of the item deleted.
No request body is required for this DELETE request.
\nEnsure that the list_id provided corresponds to an existing list.
Interact with your Drop Cowboy contact lists from your application via API.
\n","_postman_id":"6896f9b6-ff50-4187-9240-c29482d3a1a1"}],"event":[{"listen":"prerequest","script":{"id":"ab7d76c5-e0a4-471d-a20b-21badded3a92","type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"id":"7c46f3a0-d3a9-48d7-b8be-a6310e18c083","type":"text/javascript","requests":{},"exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://api.dropcowboy.com/v1"},{"key":"team_id","value":""},{"key":"secret","value":"","type":"default"}]}