Webhooks API SMS.online

Webhooks allow you to automatically receive notifications when an SMS arrives at your virtual number. If the Webhooks feature is enabled in your profile settings, the system will send a POST request to the URL you specified with the details of the received SMS.

After sending the webhook, the SMS.online server waits for a 200 HTTP status response from your script. If the server does not receive a 200 response, it will not attempt to resend the request. In this case, you will need to manually check the activation status of the number.

Webhooks provide real-time data delivery and are suitable for integration with external message monitoring systems.

Activation Webhooks

{
	"activationId": 123456,
	"service": "go",
	"text": "Sms text",
	"code": "12345",
	"country": 0,
	"receivedAt": "2025-01-01 12:00:00"
}

You can enable this feature in your profile settings.

Rental Webhooks

{ 
  "rentId": 123456, 
  "sms" : { 
    "phoneFrom" => 79999999999
    "text" => "Sms text",
    "date" => "2025-01-01 12:00:00"
  } 
}

Important: the webhook specified in your profile settings is not used when renting numbers. You need to provide the webhook URL as a uri parameter when creating the request. This allows you to flexibly manage notification addresses for each rented number.