Skip to main content
POST
/
api
/
v1
/
carrier-sales
/
trigger-call
Trigger an outbound carrier sales call
curl --request POST \
  --url https://api.fleetworks.ai/api/v1/carrier-sales/trigger-call \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "dotNumber": 5555555,
  "toPhone": "+15555555555",
  "contactName": "John Doe",
  "loadId": "12345",
  "metadata": {
    "internal_load_id": "ABC123",
    "customer_id": "12345",
    "priority": 1
  }
}'
{
  "success": true,
  "call": {
    "id": 12345,
    "fromPhone": "+15551234567",
    "toPhone": "+15559876543",
    "status": "IN_PROGRESS",
    "conversationId": 67890,
    "createdAt": "2024-03-15T14:30:00.000Z",
    "updatedAt": "2024-03-15T14:35:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

An authentication token that identifies the organization associated with the event. You can reach out to FleetWorks team to request a token.

Body

application/json
​
dotNumber
integer
required

The carrier's DOT (Department of Transportation) number. This is used to identify the carrier and prevent duplicate outreach.

Example:

5555555

​
toPhone
string
required

Phone number to call in E.164 format. Must include country code with + prefix (e.g., +15551234567). For extensions, append ;ext= followed by the extension number (e.g., +15551234567;ext=123).

Example:

"+15555555555"

​
loadId
string
required

Your load reference identifier that the carrier sales call will be about.

Example:

"12345"

​
contactName
string

Name of the contact person at the carrier. This helps personalize the sales conversation and makes the call more effective.

Example:

"John Doe"

​
metadata
object

Optional. Custom metadata as key-value pairs that will be included in webhook events. This allows you to map calls back to your internal systems when receiving webhooks. Values can be strings or numbers.

Example:
{
  "internal_load_id": "ABC123",
  "customer_id": "12345",
  "priority": 1
}

Response

Success

​
success
boolean
​
call
object | null

Call details if the call was successfully initiated.

​
message
string

Error message if the request failed.

⌘I