BlasterCalls

Launch a call

Starts an automated phone call to a destination number. The message and audio fields are mutually exclusive: if both are sent, message takes precedence and audio is ignored. An ACCEPTED status only indicates that the request was accepted for processing; it does not imply that the call was answered or completed.

Authentication

x-api-keystring
Account authentication key.

Request

This endpoint expects an object.
outbound_routestringRequired

Outbound route identifier obtained through GET /v1/blaster/outbound-routes.

phone_numberstringRequiredformat: "^\d{10}$"

10-digit Mexican phone number, without country code.

messagestringOptional

Text that will be converted to speech (TTS). Required when audio is not sent.

audiostringOptional

Audio identifier obtained through POST /v1/blaster/media/audio. Required when message is not sent.

ringtimeintegerOptional10-30Defaults to 20

Ring time in seconds before the call is considered unanswered. Optional; if not sent, the default value is applied.

transfer_tostringOptional

10-digit phone number to which the call will be transferred once answered.

retryobjectOptional
Automatic retry configuration for the call.

Response

Request accepted for processing.
message_idstring
Unique identifier of the call. It should be kept to correlate subsequent webhook events.
statusenum
Result of the initial validation of the request.
operatorstring
Phone operator identified for the destination number.
is_mobileboolean
Indicates whether the number corresponds to a mobile line.
outbound_routestring
phone_numberstring
messagestring
audiostring
ringtimeinteger
retryobject
Automatic retry configuration for the call.
transfer_tostring