Send Bulk Message

POST 
/messages/bulk

Endpoint for sending bulk messages.

Request

application/json

Body

required

Send Bulk Message Request

dest_numbers string[]

Array of destination numbers.

short_message string

Message content.

schedule_send_at date-time

Date and time when the message will be sent (optional).

validity_period integer

Validity period of the message in seconds (optional).

Responses

200

Bulk Messages sent successfully.

application/json

Schema

Schema

status object

message string

A message describing the status of the operation.

error_code integer

Http Error Code.

errors string[]

A list of error messages (empty for success).

messages object[]
Array [
id string
The id of the message.
dest_number string
The destination number of the message.
short_message string
The message content.
schedule_send_at date-time
The date and time when the message will be sent.
created_at date-time
The date and time when the message was created.
delivered_at date-time
The date and time when the message was delivered.
validity_period integer
The validity period of the message.
]

Example (from schema)

{
  "status": {
    "message": "Status Message",
    "error_code": 200,
    "errors": []
  },
  "messages": [
    {
      "id": "1",
      "dest_number": "628123456789",
      "short_message": "Test Message",
      "schedule_send_at": "2024-01-01 12:12:12",
      "created_at": "2024-01-01 12:12:12",
      "delivered_at": "2024-01-01 12:12:12",
      "validity_period": 60
    }
  ]
}

400

Failed to send bulk message.

application/json

Schema

Schema

message string

A message describing the status of the operation.

error_code integer

Http Error Code.

errors string[]

A list of error messages (empty for success).

Example (from schema)

{
  "message": "Status Message",
  "error_code": 200,
  "errors": []
}

401

Unauthorized. Invalid token.

application/json

Schema

Schema

message string

A message describing the status of the operation.

error_code integer

Http Error Code.

errors string[]

A list of error messages (empty for success).

Example (from schema)

{
  "message": "Status Message",
  "error_code": 200,
  "errors": []
}

402

Failed to send bulk message. Insufficient Balance.

application/json

Schema

Schema

message string

A message describing the status of the operation.

error_code integer

Http Error Code.

errors string[]

A list of error messages (empty for success).

Example (from schema)

{
  "message": "Status Message",
  "error_code": 200,
  "errors": []
}

500

Internal Server Error.

application/json

Schema

Schema

message string

A message describing the status of the operation.

error_code integer

Http Error Code.

errors string[]

A list of error messages (empty for success).

Example (from schema)

{
  "message": "Status Message",
  "error_code": 200,
  "errors": []
}

Loading...