Default

Send ringless voicemail

post

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.

Authorizations
x-team-id / x-secretstringRequired

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

Body
team_idstring · enumRequired

Located on the API Setting tab. (Required)

Possible values:
secretstring · enumRequired

Located on the API Setting tab. (Required)

Possible values:
foreign_idstring · enumRequired

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

Possible values:
brand_idstring · enumRequired

Located on in your account's trust center tab. (Required)

Possible values:
phone_numberstring · enumRequired

Your contact's phone number in E.164 format. (Required)

Possible values:
recording_idstring · enumOptional

The ID of the audio recording to send to your contacts. Located on in your account's recordings tab. *Not required if you are using audio_url or voice_id

Possible values:
voice_idstring · enumOptional

The ID of the Mimic AITM voice to use when reading your tts_body. Located on in your account's voices tab. *Not required if you are audio_url or recording_id. Must use in conjunction with tts_body.

Possible values:
tts_bodystring · enumOptional

The text you want Mimic AITM to convert to speech using the voice_id you specify. *Required if using voice_id

Possible values:
audio_urlstring · enumOptional

Use of this property requires special approval. Please contact support. | A url to the voicemail audio to play (mp3 or wav). *Not required if you are using recording_id or voice_id

Possible values:
audio_typestring · enumOptional

Use of this property requires special approval. Please contact support.

Possible values:
forwarding_numberstring · enumOptional

The phone number to forward calls and texts to when the contact replies to your message. Must be in E.164 format.

Possible values:
phone_ivr_idstring · enumOptional

The IVR to use when your contact calls you back. Located on in your account's phone ivr tab.

Possible values:
pool_idstring · enumOptional

The ID of the private number pool to select phone numbers from based on geographic location of your contact.

Possible values:
postal_codestring · enumOptional

The zip code / postal code of your contact. Supplying a value for postal code is optional but provides more accurate compliance with TCPA calling hours.

Possible values:
callback_urlstring · enumOptional

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

Possible values:
byocobject · enumOptional

Wholesale customers are able to specify SIP Trunks and STIR/SHAKEN credentials.

Possible values:
Responses
200

Request accepted. Delivery status delivered via webhook callback.

application/json
post
/rvm
200

Request accepted. Delivery status delivered via webhook callback.

Send SMS

post

Invoke 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.

Authorizations
x-team-id / x-secretstringRequired

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

Body
team_idstring · enumRequired

Located on the API Setting tab. (Required)

Possible values:
secretstring · enumRequired

Located on the API Setting tab. (Required)

Possible values:
phone_numberstring · enumRequired

Your contact's phone number in E.164 format. (Required)

Possible values:
caller_idstring · enumRequired

The phone number to forward calls and texts to when the contact replies to your message. Must be in E.164 format. (Required)

Possible values:
pool_idstringRequired

The ID of the private number pool you registered to send SMS messages. (Required)

sms_bodystring · enum · max: 160Required

Plain text containing your message. Character limit is 160. (Required)

Possible values:
opt_inboolean · enumRequired

Confirmation that you obtained OPT-IN permission to send SMS to the recipient as required by law. (Required)

Possible values:
callback_urlstring · enumOptional

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

Possible values:
foreign_idstring · enum · max: 256Optional

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

Possible values:
Responses
200

Request accepted. Results include accepted_count and rejected details.

application/json
post
/sms
200

Request accepted. Results include accepted_count and rejected details.

Create contact list

post
Authorizations
x-team-id / x-secretstringRequired

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

Body
list_namestringRequired
Responses
200

Created. Returns list_id, list_name, created_at.

application/json
post
/list
200

Created. Returns list_id, list_name, created_at.

Get contact list details

get
Authorizations
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

List details including contact_count.

application/json
get
/list/{list_id}
200

List details including contact_count.

Rename contact list

post
Authorizations
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
list_namestringRequired
Responses
200

200 OK on success

No content

post
/list/{list_id}
200

200 OK on success

No content

Delete contact list

delete
Authorizations
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}
200

200 OK on success

No content

Append contacts to a list

post
Authorizations
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
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
200

Returns accepted_count and rejected details.

List brands

get

Invoke our brand api from your application by sending an HTTP GET containing with the attributes listed.

Authorizations
x-team-id / x-secretstringRequired

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

Responses
200

Array of brands

application/json
get
/brand
200

Array of brands

List media

get

Invoke our recordings api from your application by sending an HTTP GET containing with the attributes listed.

Authorizations
x-team-id / x-secretstringRequired

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

Query parameters
api_allowedbooleanOptional

Filter brands by whether API access has been granted or not.

Responses
200

Array of recordings

application/json
get
/recording
200

Array of recordings

List media

get

Invoke our recordings api from your application by sending an HTTP GET containing with the attributes listed.

Authorizations
x-team-id / x-secretstringRequired

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

Responses
200

Array of media

application/json
get
/media
200

Array of media

List number pools

get

Invoke our number pool api from your application by sending an HTTP GET containing with the attributes listed.

Authorizations
x-team-id / x-secretstringRequired

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

Responses
200

Array of number pools

application/json
get
/pool
200

Array of number pools

Last updated

Was this helpful?