Add an account to a campaign

POSThttps://api.dcdial.com/api/type=add_leads

Changes dataToken

Adds one account, with its phone numbers and email addresses, to a campaign list so the campaign can call it. If you leave out list_id, a new list is created for the campaign.

Parameters

Send as application/x-www-form-urlencoded.

typestringrequired
Selects the operation. Always add_leads for this endpoint.
tokenstringrequired
Your API token from Log in. See Authentication.
campaign_idintegerrequired
Campaign the account is added to.
Example 1024
phonesstringrequired
Comma-separated phone numbers. The time zone is looked up from each number.
Example 5550100123,5550100124
list_idintegeroptional
List to add the account to. A new list is created when omitted.
Example 2048
emailsstringoptional
Comma-separated email addresses.
Example [email protected]
account_idstringoptional
Your reference for the account (its accountid).
Example ACC-10045
first_namestringoptional
First name.
Example Jane
middle_initialstringoptional
Middle initial.
last_namestringoptional
Last name.
Example Doe
titlestringoptional
Title, such as Mr or Ms.
address1stringoptional
Address line 1.
Example 100 Main St
address2stringoptional
Address line 2.
address3stringoptional
Address line 3.
citystringoptional
City.
Example Atlanta
statestringoptional
Two-letter state code.
Example GA
postal_codestringoptional
ZIP or postal code.
Example 30301
postalgmtstringoptional
How to work out the account’s time zone: AREA (by area code, the default) or POSTAL (by postal code).
Example AREA
countrystringoptional
Country code.
Example US
balancenumberoptional
Outstanding balance.
Example 1250.5
genderstringoptional
Gender.
birthdaystringoptional
Date of birth (YYYY-MM-DD).
company_namestringoptional
Company name, for business accounts.
company_websitestringoptional
Company website, for business accounts.
source_idstringoptional
Your source or vendor reference.
custom1stringoptional
Custom fields custom1 to custom20. They are stored on the account and can be used in scripts and templates.

Notes

Send one request per account. To load many accounts at once, use Upload an account file.

curl https://api.dcdial.com/api/ \
  -d type=add_leads \
  -d token="$DCDIAL_TOKEN" \
  -d campaign_id=1024 \
  -d phones='5550100123,5550100124'

<?php
$ch = curl_init('https://api.dcdial.com/api/');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'type' => 'add_leads',
        'token' => getenv('DCDIAL_TOKEN'),
        'campaign_id' => 1024,
        'phones' => '5550100123,5550100124',
    ]),
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['response']['success'] ?? 0) != 1) {
    throw new RuntimeException($result['response']['error'] ?? 'Request failed');
}

const res = await fetch('https://api.dcdial.com/api/', {
  method: 'POST',
  body: new URLSearchParams({
    type: "add_leads",
    token: process.env.DCDIAL_TOKEN,
    campaign_id: "1024",
    phones: "5550100123,5550100124",
  }),
});
const { response } = await res.json();
if (response.success != 1) throw new Error(response.error);

import os
import requests

r = requests.post(
    "https://api.dcdial.com/api/",
    data={
        "type": "add_leads",
        "token": os.environ["DCDIAL_TOKEN"],
        "campaign_id": 1024,
        "phones": "5550100123,5550100124",
    },
    timeout=30,
)
response = r.json()["response"]
if str(response.get("success")) != "1":
    raise RuntimeError(response.get("error"))

{
  "response": {
    "success": "1",
    "msg": "Thanks! Our Support team will contact you soon"
  }
}

Add an account to a campaign

Parameters

Notes

Try it