Drop Customer API

Overview: Our Customer API is set up to handle incoming http/https posts. We will return JSON in our responses.

*You must have the API Enabled in order to use our API. You can enable from our portal under your profile or you may request more information from info@drop.co.

VMDrop™ Create
post/VMDropCreate

Overview: This will allow customers to create a VM Drop campaign.

Method: HTTP POST

Definition

Query String

ApiKey
string

Customer API Key found in welcome email or customer profile

required
VMDropName
string

Name of your new VMDrop™ Campaign, cannot have duplicate names.

required
VMDropFileUrl
string

Must be a valid Http/Https URL of your audio file that you want to create VMDrop™ from. Must be publicly available URL. Can be from http or https locations. Audio file must be 60 seconds or less in duration.

required
EnableMissedCall
boolean

Enable missed call notifications for the VMDrop™ Campaign

required
CallbackForwardingType
integer

We offer 3 options which determine what happens on callbacks.

1 - Immediate call transfer. 2 – IVR Recording with Call Transfer and DNC options. 3 – IVR Recording only.

required
IVRFileUrl
string

Required if IVR Recording with Call Transfer and DNC options or IVR Recording only is selected. Must be a valid Http/Https URL of your audio file that you want to play on callbacks. Must be publicly available URL. Can be from http or https locations. Audio file should be 60 seconds or less in duration.

optional
TransferNumber
string

Required if Immediate call transfer is selected. The number you want inbound callbacks transferred to. Needs to be valid US Phone number format. (Ex. 6126787888)

optional
RepId
string

Optional: Can be used if creating for call center reps. This can be used to identify which campaigns belong to which call reps.

optional

application/json

200
Schema Example
expand all
object
ApiCalledOn
string
optional
ApiCalledFromIp
string
optional
ApiStatusCode
integer
optional
ApiStatusMessage
string
optional
CampaignId
integer
optional
CampaignName
string
optional
CampaignToken
string
optional
AllowableCampaignCount
integer
optional
VMDropDuration
integer
optional
VMDropFile
string
optional
IVRDropDuration
integer
optional
IVRDropFile
string
optional
Results
string
optional
                                                                            {
                                                                            "ApiCalledOn": "2020-05-11T15:40:13",
                                                                            "ApiCalledFromIp": "173.25.122.189",
                                                                            "ApiStatusCode": 1000,
                                                                            "ApiStatusMessage": "API Success",
                                                                            "CampaignId": 51184,
                                                                            "CampaignName": "Drop Campaign",
                                                                            "CampaignToken": "aa3cf6b8-3a19-4ad3-86a4-1a7bf5602d83",
                                                                            "AllowableCampaignCount": 105,
                                                                            "VMDropDuration": 38,
                                                                            "VMDropFile": "https://www.drop.co/tech/LRMonoPhase4.wav",
                                                                            "IVRDropDuration": 33,
                                                                            "IVRDropFile": "https://www.drop.co/uploads/2017/11/file_example_WAV_1MG.wav",
                                                                            "Results": "Your VMDrop™ campaign is in the process of being created. Please allow up to 10 minutes for all of the backend settings to be finalized before your VMDrop™ campaign is fully created."
                                                                            }
                                                                               
VMDrop™ Update Settings
post/VMDropCampaignSettings

Overview: This will allow customers to update some common VMDrop™ campaign settings after it is created.

Method: HTTP POST

Definition

Query String

ApiKey
string

Customer API Key found in welcome email or customer profile

required
CampaignToken
string

VMDrop™ Campaign token returned from VMDrop™ Create api call.

required
EnableMissedCall
boolean

Enable missed call notifications for the VMDrop™ Campaign.

required
EnablePacing
boolean

Allows pacing limits on VMDrop™ sends.

default
required
EnableNationalDNC
boolean

Regardless of your choice to cleanse your data against the National DNC list, you are confirming that you have the necessary permission to contact/call the leads you load into this Campaign. You agree to take on all liability, as well as indemnify Drop Inc. from any issues that may arise.

default
optional
EnableStateDNC
boolean

Regardless of your choice to cleanse your data against the State DNC list (currently Pennsylvania, Wyoming, Texas, Colorado, Florida, Indiana), you are confirming that you have the necessary permission to contact/call the leads you load into this Campaign. You agree to take on all liability, as well as indemnify Drop Inc. from any issues that may arise.

default
optional
PacingType
integer

Required if EnablePacing is enabled. We offer 3 options for Pacing types.

1 - 60 minute increments. 2 – 30 minute increments. 3 – 15 minute increments.

optional
PacingLimit
integer

Required if EnablePacing is enabled. This will determine the amount of VMDrop™ sends within the Pacing Type interval.

optional

Responses application/json

200
SchemaExample
collapse all
object
ApiCalledOn
string
optional
ApiCalledFromIp
string
optional
ApiStatusCode
integer
optional
ApiStatusMessage
string
optional
CampaignId
integer
optional
CampaignName
string
optional
CampaignToken
string
optional
Results
array[object]
optional
ShowMissedCall
boolean
optional
EnableNationalDnc
boolean
optional
EnableStateDnc
boolean
optional
EnablePacing
boolean
optional
PacingType
string
optional
PacingLimit
integer
optional
{
                                                                            "ApiCalledOn": "2020-05-12T09:13:52",
                                                                            "ApiCalledFromIp": "173.25.122.189",
                                                                            "ApiStatusCode": 1000,
                                                                            "ApiStatusMessage": "API Success",
                                                                            "CampaignId": 51184,
                                                                            "CampaignName": "Drop Campaign",
                                                                            "CampaignToken": "aa3cf6b8-3a19-4ad3-86a4-1a7bf5602d83",
                                                                            "Results": [
                                                                            {
                                                                            "ShowMissedCall": false,
                                                                            "EnableNationalDnc": false,
                                                                            "EnableStateDnc": false,
                                                                            "EnablePacing": true,
                                                                            "PacingType": "15 Minutes",
                                                                            "PacingLimit": 200
                                                                            }
                                                                            ]
}
VMDrop™ Post Records
post/Delivery

Overview: This will allow posting of data records into your VM Drop campaign for processing VM Drops. If data record passes validation, it will be placed into the VM Drop's queue.

Method: HTTP POST

Definition

Query String

ApiKey
string

Customer API Key found in welcome email or customer profile

required
CampaignToken
string

Your campaign token for the VMDrop™ campaign you want to post records into.

required
PhoneTo
string

The phone number you want to leave the VMDrop™ on. Must be valid US phone format. (Ex. 6123457888)

required
Audio
string

Must be a valid Http/Https URL of your audio file that you want to leave the VMDrop™. Must be publicly available URL. Can be from http or https locations. Audio file must be 60 seconds or less in duration. This is optional and can be used to override any audio file(s) you have saved in your campaign.

optional
AllowDuplicates
boolean

By default, this is true on the backend and will allow duplicate records into your campaign's queue. You can turn it off by setting to false and it will de-dupe records for the campaign for the last 3 days.

default
optional
Source
string

If you would like to send the source of the data record for identifying the record source description. Our Send API will do nothing with this, it’s for informational purposes only.

optional
IPAddress
string

If you would like to send the IP address of the data record for identifying the record IP address. Our Send API will do nothing with this, it’s for informational purposes only.

optional
C1
string

Custom Field 1. Our Send API will do nothing with this, it’s for informational purposes only.

optional
C2
string

Custom Field 2. Our Send API will do nothing with this, it’s for informational purposes only.

optional
C3
string

Custom Field 3. Our Send API will do nothing with this, it’s for informational purposes only.

optional
C4
string

Custom Field 4. Our Send API will do nothing with this, it’s for informational purposes only.

optional
C5
string

Custom Field 5. Our Send API will do nothing with this, it’s for informational purposes only.

optional

Responses application/json

200
SchemaExample
collapse all
object
ApiCalledOn
string
optional
ApiCalledFromIp
string
optional
ApiStatusCode
integer
optional
ApiStatusMessage
string
optional
ActivityToken
string
optional
PhoneTo
string
optional
PhoneFrom
string
optional
DateTime
string
optional
ActivityEvents
null
optional
VmDropStatusUrl
string
optional
AudioFile
string
optional
CampaignId
string
optional
C1
string
optional
C2
string
optional
C3
string
optional
C4
string
optional
C5
string
optional
Source
string
optional
ValidationLevel
integer
optional
{
                                                                            "ApiCalledOn": "2020-05-12T07:44:33",
                                                                            "ApiCalledFromIp": "173.25.122.189",
                                                                            "ApiStatusCode": 1038,
                                                                            "ApiStatusMessage": "API Post Accepted",
                                                                            "ActivityToken": "05124b3f-65ca-427a-8f18-f6ecce3eb24a",
                                                                            "PhoneTo": "9529949006",
                                                                            "PhoneFrom": "",
                                                                            "DateTime": "2020-05-12T07:44:33.7652467-05:00",
                                                                            "ActivityEvents": null,
                                                                            "VmDropStatusUrl": "https://customerapi.drop.co/VMDropStatus/?activitytoken=05124b3f-65ca-427a-8f18-f6ecce3eb24a",
                                                                            "AudioFile": "http://www.drop.co/active/voiceBsystem/upload/1562160751_test.mp3",
                                                                            "CampaignId": "50501",
                                                                            "C1": "C1 string",
                                                                            "C2": "C2 string",
                                                                            "C3": "C3 string",
                                                                            "C4": "C4 string",
                                                                            "C5": "C5 string",
                                                                            "Source": "Source string",
                                                                            "ValidationLevel": 1
}
Customer Web Hook - Post
post/YourWebHook

You can set a custom web hook url inside your Customer Profile page and enable web hook capabilities. Drop will post to your web hook when status is returned on a VMDrop™.

We will do blind posts to your web hook url and look for 200 ok response. If we receive a 200 ok response, we have successfully posted to your web hook. Any other http response and we will mark it as a failed post attempt to your web hook.

Definition

Request Body application/json

SchemaExample
collapse all
object
ApiCalledOn
string
optional
ApiCalledFromIp
string
optional
ApiStatusCode
integer
optional
ApiStatusMessage
string
optional
DropId
null
optional
DropStatusCode
integer
optional
DropStatusMessage
null
optional
CampaignId
string
optional
C1
string
optional
C2
string
optional
C3
string
optional
C4
string
optional
C5
string
optional
Source
string
optional
ValidationLevel
integer
optional
{
                                                                "ApiCalledOn": "2020-05-07T15:18:29",
                                                                "ApiCalledFromIp": "172.107.60.70",
                                                                "ApiStatusCode": 1044,
                                                                "ApiStatusMessage": "Failed-Invalid State Per Business Rule",
                                                                "DropId": null,
                                                                "DropStatusCode": -1,
                                                                "DropStatusMessage": null,
                                                                "CampaignId": "50286",
                                                                "C1": "C1 string",
                                                                "C2": "C2 string",
                                                                "C3": "C3 string",
                                                                "C4": "C4 string",
                                                                "C5": "C5 string",
                                                                "Source": "Source string",
                                                                "ValidationLevel": 1
}

Responses application/json

200
No response body.
VMDrop™ Get Campaign Stats
post/VMDropStats

Overview: This will get reporting by campaign and date range. Completed, Failed, In Progress, In Queue, Delivery Percentage, Callbacks, Transfers, DNC and Campaign Cost will be returned.

Method: HTTP POST

Definition

Query String

ApiKey
string

Customer API Key found in welcome email or customer profile.

required
CampaignToken
string

Your campaign token for the VMDrop™ campaign you want stats on.

required
DateFrom
string

Must be format like ‘10/15/2019’

required
DateTo
string

Must be format like ‘10/25/2019’

required

Responses application/json

200
Schema Example
collapse all
object
ApiCalledOn
string
optional
ApiCalledFromIp
string
optional
ApiStatusCode
integer
optional
ApiStatusMessage
string
optional
CampaignId
integer
optional
CampaignName
string
optional
CampaignToken
string
optional
DateTo
string
optional
DateFrom
string
optional
Results
object
optional
Token
string
optional
Name
string
optional
SuccessCount
integer
optional
FailCount
integer
optional
DeliveryRate
number
optional
InProgressCount
integer
optional
QueueCount
integer
optional
CustomerCost
integer
optional
DNCCount
null
optional
CallbackCount
integer
optional
TransferCount
integer
optional
{
                                                                            "ApiCalledOn": "2020-05-12T07:28:11",
                                                                            "ApiCalledFromIp": "173.25.122.189",
                                                                            "ApiStatusCode": 1000,
                                                                            "ApiStatusMessage": "API Success",
                                                                            "CampaignId": 50747,
                                                                            "CampaignName": "Drop Campaign",
                                                                            "CampaignToken": "c51ded61-ce6b-4d5a-bb86-7aa0447cce09",
                                                                            "DateTo": "2020-05-06T00:00:00",
                                                                            "DateFrom": "2020-05-06T00:00:00",
                                                                            "Results": {
                                                                            "Token": "c51ded61-ce6b-4d5a-bb86-7aa0447cce09",
                                                                            "Name": "March 31 2020 - IG - Phil",
                                                                            "SuccessCount": 39631,
                                                                            "FailCount": 14361,
                                                                            "DeliveryRate": 73.4,
                                                                            "InProgressCount": 0,
                                                                            "QueueCount": 15889,
                                                                            "CustomerCost": 254,
                                                                            "DNCCount": null,
                                                                            "CallbackCount": 2733,
                                                                            "TransferCount": 2668
                                                                            }
}
VMDrop™ Get Status
post/VMDropStatus

Overview: This will allow the current status of the VM Drop to be retrieved. You must pass in the Activity Token you got back from posting the initial record in.

Method: HTTP POST

Definition

Query String

ActivityToken
string

Activity Token you received back from posting your data record in. this was returned in the initial response.

required

Responses application/json

200
SchemaExample
collapse all
object
ApiCalledOn
string
optional
ApiCalledFromIp
string
optional
ApiStatusCode
integer
optional
ApiStatusMessage
string
optional
DropId
string
optional
DropStatusCode
integer
optional
DropStatusMessage
string
optional
CampaignId
string
optional
C1
string
optional
C2
string
optional
C3
string
optional
C4
string
optional
C5
string
optional
Source
string
optional
ValidationLevel
integer
optional
string
optional
{
                                                                            "ApiCalledOn": "2020-05-12T07:40:23",
                                                                            "ApiCalledFromIp": "173.25.122.189",
                                                                            "ApiStatusCode": 1000,
                                                                            "ApiStatusMessage": "API Success",
                                                                            "DropId": "012539b2-d914-41ed-8e31-1be5bcff7416",
                                                                            "DropStatusCode": 0,
                                                                            "DropStatusMessage": "Completed",
                                                                            "CampaignId": "50770",
                                                                            "C1": "C1 string",
                                                                            "C2": "C2 string",
                                                                            "C3": "C3 string",
                                                                            "C4": "C4 string",
                                                                            "C5": "C5 string",
                                                                            "Source": "Source string",
                                                                            "ValidationLevel": 2
}
VMDrop™ Get Aggregate Reporting Stats
post/VMDropActivityStats

Overview: This will allow activity reporting stats for a campaign. This will include validation level stats such as duplicate checking, mobile line validation, reasons for failure, etc.

Method: HTTP POST

Definition

Query String

ApiKey
string

Customer API Key found in welcome email or customer profile.

required
CampaignToken
string

Campaign token for the VMDrop™ campaign you are requesting activity reporting for.

required
DateFrom
string

Must be format like ‘10/15/2019’.

required
DateTo
string

Must be format like ‘10/15/2019’.

required

Responses application/json

200
SchemaExample
collapse all
object
ApiCalledOn
string
optional
ApiCalledFromIp
string
optional
ApiStatusCode
integer
optional
ApiStatusMessage
string
optional
CampaignId
integer
optional
CampaignName
string
optional
CampaignToken
string
optional
DateTo
string
optional
DateFrom
string
optional
Results
array[object]
optional
ResponseStatus
string
optional
Count
integer
optional
ValidationLevel
null or string
optional
{
                                                                            "ApiCalledOn": "2020-05-12T07:34:26",
                                                                            "ApiCalledFromIp": "173.25.122.189",
                                                                            "ApiStatusCode": 1000,
                                                                            "ApiStatusMessage": "API Success",
                                                                            "CampaignId": 50747,
                                                                            "CampaignName": "Drop Campaign",
                                                                            "CampaignToken": "c51ded61-ce6b-4d5a-bb86-7aa0447cce09",
                                                                            "DateTo": "2020-05-06T00:00:00",
                                                                            "DateFrom": "2020-05-06T00:00:00",
                                                                            "Results": [
                                                                            {
                                                                            "ResponseStatus": "Upload Success",
                                                                            "Count": 72481,
                                                                            "ValidationLevel": null
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Upload Failed",
                                                                            "Count": 22516,
                                                                            "ValidationLevel": null
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Failed - AlreadyExistInDB",
                                                                            "Count": 22516,
                                                                            "ValidationLevel": null
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "API Success",
                                                                            "Count": 53992,
                                                                            "ValidationLevel": "AcceptanceValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Failed-Landline",
                                                                            "Count": 4157,
                                                                            "ValidationLevel": "AcceptanceValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Failed-Invalid State For System Sending",
                                                                            "Count": 78,
                                                                            "ValidationLevel": "AcceptanceValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Failed-Phone Blacklisted",
                                                                            "Count": 281,
                                                                            "ValidationLevel": "AcceptanceValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Failed-Customer DNC",
                                                                            "Count": 16,
                                                                            "ValidationLevel": "AcceptanceValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Previous Day Re-Attempt - In Progress-Sent",
                                                                            "Count": 2,
                                                                            "ValidationLevel": "SendAPIValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Previous Day Re-Attempt - Failed-Carrier Rejected",
                                                                            "Count": 2213,
                                                                            "ValidationLevel": "SendAPIValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Previous Day Re-Attempt - Failed-Line Busy",
                                                                            "Count": 1878,
                                                                            "ValidationLevel": "SendAPIValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Completed",
                                                                            "Count": 39631,
                                                                            "ValidationLevel": "SendAPIValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Failed-VM Unreachable",
                                                                            "Count": 11303,
                                                                            "ValidationLevel": "SendAPIValidation"
                                                                            },
                                                                            {
                                                                            "ResponseStatus": "Failed-RVM Vmail Not Detected",
                                                                            "Count": 3058,
                                                                            "ValidationLevel": "SendAPIValidation"
                                                                            }
                                                                            ]
}