Skip to main content
POST
/
{instance}
/
send-message
Send Message
curl --request POST \
  --url https://app.hypersender.com/api/sms/v1/{instance}/send-message \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "content": "v",
  "request_id": "133554b5-ae44-44a0-8f4f-7bbac5657a11",
  "to": "+1119122018"
}'
{
  "id": "string",
  "request_id": "string",
  "phone": {
    "id": "string",
    "user_id": "string",
    "phone_number": "string",
    "name": "string",
    "sim": "string",
    "max_send_attempts": 0,
    "message_expiration_seconds": 0,
    "missed_call_auto_reply_message": null,
    "is_online": true,
    "last_online_at": "string",
    "last_offline_at": "string",
    "last_message_at": "string",
    "last_missed_call_at": "string",
    "last_heartbeat_at": "string",
    "heartbeat_enabled_at": null,
    "timezone": "string",
    "created_at": "string",
    "updated_at": "string"
  },
  "message_thread": {
    "id": "string",
    "phone_id": "string",
    "last_message_id": "string",
    "from_phone_number": "string",
    "to_phone_number": "string",
    "is_archived": true,
    "last_message_content": "string",
    "last_message_at": "string",
    "created_at": "string",
    "updated_at": "string"
  },
  "message_thread_id": "string",
  "phone_id": "string",
  "from_phone_number": "string",
  "to_phone_number": "string",
  "content": "string",
  "send_duration": null,
  "schedule_on_phone_at": null,
  "sent_at": null,
  "last_attempted_at": null,
  "delivered_at": null,
  "received_at": "string",
  "expired_at": null,
  "schedule_send_at": null,
  "failed_at": null,
  "send_attempt_count": 0,
  "max_send_attempts": 0,
  "failure_reason": null,
  "message_expiration_seconds": 0,
  "timezone": "string",
  "sim": "string",
  "status": "string",
  "type": "string",
  "created_at": "string",
  "updated_at": "string"
}
Send a new SMS message to be sent by your android phone, you can schedule it up to 3 days in the future relative to your defined phone timezone. you can also specify an unique request id that you can use later to search for this message.

​
Quick Demo

Learn how to use Hypersender SMS API to send a message using Postman: Demo Link

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
instance
string
required

Instance UUID copied from hypersender dashboard

Example:

"{{ instance_id }}"

Body

application/json
​
content
string
required

The content of your SMS message, keep it short and sweet because sms messages done like to be short!

​
to
string
required

phone number that you want to send the message to. Make sure that it start with + and have country code example: +203123131313

​
request_id
string

any string preferably uuid that you can use later to find this message.

​
schedule_send_at
string

optional date in the future max: 3 days that the message will be sent Relative to your defined Timezone! Example: 2025-01-08 19:47:00

​
max_send_attempts
integer

How many times I should retry sending this message when it fails to be sent, Max: 15 times.

​
message_expiration_seconds
integer

How many seconds this message is valid for, this is usefull when you are sending OTPs with expiration of 2 mins.

Response

Successful response

​
id
string
​
request_id
string
​
phone
object
​
message_thread
object
​
message_thread_id
string
​
phone_id
string
​
from_phone_number
string
​
to_phone_number
string
​
content
string
​
send_duration
string
​
schedule_on_phone_at
string
​
sent_at
string
​
last_attempted_at
string
​
delivered_at
string
​
received_at
string
​
expired_at
string
​
schedule_send_at
string
​
failed_at
string
​
send_attempt_count
integer
​
max_send_attempts
integer
​
failure_reason
string
​
message_expiration_seconds
integer
​
timezone
string
​
sim
string
​
status
string
​
type
string
​
created_at
string
​
updated_at
string
⌘I