Supported Formats

json

Examples

curl -H "Content-Type: application/json" -X POST -d '{"name":"Call Centre 1", number: "+18004457682"}' https://[your-subdomain].trackdrive.net/api/v1/buyers?auth_token=[your-auth-token]

Params

Param name
Description
auth_token
Optional

Authorize requests using your token. Get it from your profile: trackdrive.net/profile/edit

  • Must be String

serializer
Optional Blank Value Allowed

This endpoint supports multiple response formats. Pass serializer=name to retrieve data in an alternate format.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    buyerDefault response format.
    buyer_gridModern response format that returns various foreign keys for use with other API endpoints.
copy_another_buyer
Optional

Copy another buyer?

  • Must be a boolean value: 1, true, yes, on, 0, false, no, off

user_buyer_id
Optional

User Buyer

  • Must be String

number
Optional

Number

  • Must be String

name
Optional

Name

  • Must be String

timeout_seconds
Optional

Timeout Seconds

  • Must be a decimal number.

dtmf_tones
Optional Blank Value Allowed

Dtmf Tones

  • Must be String

time_zone
Optional

Date ranges will be parsed using this time zone.

buyer_suppression_ids
Optional Blank Value Allowed

The list of internal suppression id's that will be assigned to this buyer.

paused
Optional

Paused

  • Must be a boolean value: 1, true, yes, on, 0, false, no, off

record_calls
Optional

Record Calls

  • Must be a boolean value: 1, true, yes, on, 0, false, no, off

press_one_to_accept
Optional Blank Value Allowed

Press One To Accept

  • Must be a boolean value: 1, true, yes, on, 0, false, no, off

generate_team
Optional

Grant access to edit this Buyer, and view calls that it paid for.

  • Must be a boolean value: 1, true, yes, on, 0, false, no, off

team_users_emails
Optional Blank Value Allowed

The selected users will recieve an email invitation to collaborate on your company.

  • Must be an array of emails. EG: ["john-smith@gmail.com", "example@domain.com"]

team_offer_ids
Optional Blank Value Allowed

Team members can view calls made to these Offers that were paid for by their Buyer.

  • Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers

token_values
Optional Blank Value Allowed

Callers will be routed to Buyers with matching tokens.

  • Must be a valid list of filters. Example filters:
    ["interest:auto", "loan_amount:>=10000", "loan_amount:<=50000", "geo:!=800", "caller_id:!=anonymous"]
attribution_token_values
Optional Blank Value Allowed

When this Buyer is connected to a Caller, the Call will be tagged with these tokens.

  • Must be a valid list of tokens. Example tokens:
    ["buyer_interest:loan","another_token:value"]
route_by_type
Optional

Route By Type

  • Must be one of: tier, revenue, epc.

tier
Optional Blank Value Allowed

Tier

  • Must be a decimal number.

epc_timeframe
Optional Blank Value Allowed

Epc Timeframe

  • Must be a decimal number.

epc_assumed_amount
Optional Blank Value Allowed

Epc Assumed Amount

  • Must be a decimal number.

epc_assumed_calls_count
Optional Blank Value Allowed

Epc Assumed Calls Count

  • Must be a decimal number.

weight
Optional Blank Value Allowed

Weight

  • Must be a decimal number.

display_caller_id_type
Optional

Display Caller Id Type

  • Must be one of: display_caller_id, display_fake_caller_id, display_trackdrive_number_id.

display_trackdrive_number_id
Optional Blank Value Allowed

Display Trackdrive Number

concurrency_cap_limit
Optional Blank Value Allowed

Choose the number of concurrent calls that can be forwarded to this buyer simultaneously.

  • Must be a decimal number.

attempt_total_limit
Optional Blank Value Allowed

Attempt caps limit the number of times a buyer can be attempted in a given interval.

  • Must be a decimal number.

attempt_monthly_limit
Optional Blank Value Allowed

Monthly Attempt Cap

  • Must be a decimal number.

attempt_daily_limit
Optional Blank Value Allowed

Daily Attempt Cap

  • Must be a decimal number.

connection_total_limit
Optional Blank Value Allowed

Connection caps limit the number of times a buyer can be connected in a given interval.

  • Must be a decimal number.

connection_monthly_limit
Optional Blank Value Allowed

Monthly Connection Cap

  • Must be a decimal number.

connection_daily_limit
Optional Blank Value Allowed

Daily Connection Cap

  • Must be a decimal number.

buyer_conversion_total_limit
Optional Blank Value Allowed

Conversion caps limit the number of times a buyer can convert in a given interval.

  • Must be a decimal number.

buyer_conversion_monthly_limit
Optional Blank Value Allowed

Monthly Conversion Cap

  • Must be a decimal number.

buyer_conversion_daily_limit
Optional Blank Value Allowed

Daily Conversion Cap

  • Must be a decimal number.

revenue_total_limit
Optional Blank Value Allowed

Revenue caps limit the dollar amount that can be paid by a buyer in a given interval.

  • Must be a decimal number.

revenue_monthly_limit
Optional Blank Value Allowed

Monthly $ Revenue Cap

  • Must be a decimal number.

revenue_daily_limit
Optional Blank Value Allowed

Daily $ Revenue Cap

  • Must be a decimal number.

business_hours_schedule
Optional

[

{
    attempt_hourly_limit: 10,
    connection_hourly_limit: 10,
    buyer_conversion_hourly_limit: 10,
    revenue_hourly_limit: 10,
    schedule: [
        {
            day: 0,
            times: ["11:00..13:09", "14:00..15:09"]
        },
        {
            day: 1,
            times: ["11:10..18:39", "19:10..23:39"]
        }
    ]
}

]

  • Must be an array of any type

buyer_conversions_schedule
Optional

[

{
    buyer_conversions_attributes: [
        {
            name: '10$ conversion at 1 minute, deduped every 2 hours',
            duration: 60,
            revenue: 10,
            duplicate_timeframe: 7200
        }
    ],
    schedule: [{"day":0,"times":["00:00..23:59"]},{"day":1,"times":["00:00..23:59"]},{"day":2,"times":["00:00..23:59"]},{"day":3,"times":["00:00..23:59"]},{"day":4,"times":["00:00..23:59"]},{"day":5,"times":["00:00..23:59"]},{"day":6,"times":["00:00..23:59"]}]
}

]

  • Must be an array of any type

current_conversion_revenue_max
Optional

The maximum valid revenue for the current time frame.

  • Must be a decimal number.

current_conversion_revenue_min
Optional

The minimum valid revenue for the current time frame.

  • Must be a decimal number.

current_conversion_revenue_increment
Optional

Bids must be increased/decreased by this amount for the current time frame.

  • Must be a decimal number.

current_conversion_revenue
Optional

The number of dollars paid per call in increments of $0.01 for the current time frame.

  • Must be a decimal number.

current_conversion_duration
Optional

The number of seconds for a call to payout. If this is set to 0 the call will convert when this buyer is dialed for the current time frame.

  • Must be a decimal number.

current_conversion_duplicate_timeframe
Optional

The period of time that must elapse before a buyer will pay for the same caller to be transferred.

  • Must be a decimal number.

current_conversion_name
Optional

This name that will appear in call logs.

  • Must be String

current_conversion_token_values
Optional Blank Value Allowed

Conversion will only occur if the caller matches these filters.

  • Must be a valid list of filters. Example filters:
    ["interest:auto", "loan_amount:>=10000", "loan_amount:<=50000", "geo:!=800", "caller_id:!=anonymous"]
current_conversion_attribution_token_values
Optional Blank Value Allowed

If the call converts, these tokens will be applied to the call.

  • Must be a valid list of tokens. Example tokens:
    ["buyer_interest:loan","another_token:value"]