Drop Cowboy

API

Getting Started

Directly 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. Once delivery is attempted, you will receive a callback containing the delivery status to the webhook you specified in your API settings contained in your account.

Sending Ringless Voicemail via API
https://api.dropcowboy.com/v1/rvm
POST

Content-Type: application/json

Attributes

team_id

STRING

Located on the API Setting tab

Example: [Your Account]

secret

STRING

Located on the API Setting tab

Example: [Your Secret]

foreign_id

STRING

A value to identify this drop in your system. Will be passed through to you in the webhook callback. Max length 256 characters.

Example: [Your system's ID]

audio_url

STRING

A url to the voicemail audio to play (mp3 or wav)

Example: https://example.com/your-file.mp3

audio_type

STRING

The file type of audio_url: 'mp3' or 'wav'

Example: 'mp3'

phone_number

STRING

Your contact's phone number in E.164 format

Example: '+15552223333'

caller_id

STRING

The sender's phone number in E.164 format

Example: '+15557778888'

callback_url

STRING

Optional: Override the default RVM webhook url that you specified in your API settings.

Example: 'http://example.com'

Example:

curl --header "Content-Type: application/json" \
--data {"team_id": "<your team_id>", "secret": "<your secret>", "audio_url": "https://example.com/your-file.mp3", "audio_type": "mp3", "phone_number": "+15552223333", "caller_id":"+15557778888", "foreign_id": "<your system value>"} \
https://api.dropcowboy.com/v1/rvm

System will call the callback url specified in the settings tab with json content like this:

Success
Failure
Possible Error Reasons
Error from SIP Server

The phone number is not reachable - usually because it is no longer in service.

Temporarily unreachable

The phone number is experiencing a localized service outage.

VoiceMail NotDetected

The phone number does not have voicemail capability.

No Funds

Your Drop Cowboy account is out of money.

Known Litigator

The phone number is a known TCPA litigator.

Not Mobile

The phone number is a landline (only possible to get this error via the Drop Cowboy UI and not through the API).

User Busy

The telephone carrier actively rejected our voicemail attempt - usually because they marked your message attempt as spam.

Internal DNC

The phone number is on your Drop Cowboy DNC list and therefore blocked.

ringless voicemail countries

Millions of Voicemails Delivered Daily

We support sending ringless voicemail to more than 80 countries including

Austria

Belgium

Denmark

Finland

France

Germany

Ireland

Mexico

The Netherlands

New Zealand

Norway

Spain

Sweden

Switzerland

United States

See for yourself why so many have embraced ringless voicemail!

There's no monthly fees, minimums, or commitment to get started.
Drop Cowboy
Drop Cowboy © 2018 All rights reserved.

Drop Cowboy is a responsible use company. Our customers are required by our Terms of Use to comply with all applicable laws and regulations. If you received an unwanted voicemail from one of our customers, please report it to abuse@dropcowboy.com.

30 N. Gould St., Ste 2890
Sheridan, WY 82801
USA

1 (307) 655 7586