API documentation

POST /inbound_webhooks/post/:vanity_uri

Ping ID or webhook vanity URI required

https://[your-subdomain].trackdrive.com/api/v1/inbound_webhooks/post/:vanity_uri

Post a ping for a tracking number

POST with a ping_id to retrieve a tracking number for forwarding an inbound call to a matching buyer.

Params

Param name	Description
vanity_uri Optional	The unique identifier for this endpoint. Must be a String
ping_id Optional	Ping ID Must be a String

Param name

Description

vanity_uri
Optional

The unique identifier for this endpoint.

Must be a String

ping_id
Optional

Ping ID

Must be a String

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/inbound_webhooks/post/example_ping' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "ping_id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "zip": "60601"
}'

Example Response 200

{
  "success": true,
  "status": "accepted",
  "errors": [],
  "tracking_type": "caller_number",
  "buyers": [
    {
      "id": 10001,
      "offer_conversion_payout": 25.0,
      "concurrency_cap_limit": null,
      "concurrency_cap_available": 9999,
      "current_conversion_duration": 90,
      "offer_conversion_duplicate_timeframe": 0
    },
    {
      "id": 10002,
      "offer_conversion_payout": 25.0,
      "concurrency_cap_limit": null,
      "concurrency_cap_available": 9999,
      "current_conversion_duration": 90,
      "offer_conversion_duplicate_timeframe": 0
    }
  ],
  "ping_ids_expiry_in_seconds": 3600,
  "forwarding_number_status": "accepted",
  "forwarding_number": "+18445550150",
  "forwarding_number_sip_address": "18445550150@sip.trackdrive.com",
  "lead_id": "a09e6bca-255b-4217-af73-cb9601c80217"
}