Is RPS not enough? Webhook solves this problem

We have improved Webhook, and it's time to remind you that when you use API Webhook may significantly speed up your work. This applies to both activation and rent.

Webhook is a modern and convenient integration mechanism that optimizes the use of our API. In the context of SMS activations, Webhook is used to automatically transfer the content of incoming SMS messages to the URL address you specify. To make it simple, it allows you to transfer information from our server to yours with a POST request.

What is the difference between a regular request and Webhook

How an SMS request without Webhook works in case of an activation:

• A request to receive an SMS is generated on your side;
• The request is sent continuously until the SMS is received. The frequency of requests is configured by the user, but anyway you either use up your RPS limit or waste extra time. Once the limit is reached, registrations will stop (= downtime).

How Webhook works

Activation:

• A user sets up the address where webhooks will be sent;
• A number is purchased;
• After the number receives an SMS, a code is sent to the user's address. No additional actions required on the side of the user;
• Your server must respond with an HTTP code 200 to confirm successful receipt of the data.

Rent:

The same algorithm, but there is a small difference: the customer explicitly provides the address with each number purchase.

Response:

{
"rentId": "26251422",
"sms": {
"phoneFrom": "SPORTMASTER",
"text": "Код для регистрации в Спортмастер 2792",
"date": "2025-06-17 16:01:10"
}
}

What's the benefit:

You don't send a request, you receive a POST request. This means that RPS are not spent.

How to start using Webhook

If you use self-written software for registration or a bot:

1. Get URL addresses for the webhook: create a server that will receive HTTP requests. This can be your own server or a service that provides the ability to accept webhooks.
2. Activate webhooks in your SMS-Activate account: in the upper right corner of the site, click “Profile”, scroll down to “Webhook Activations Addresses,” and click “Webhook Activations Addresses.” Enter the address.

Your server must be configured to process incoming POST requests. An example of the data you will receive may look like this:

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

Pay attention to the following parameters:

• activationId: ID of the activation which an SMS was sent to.
• text: text of the received SMS.
• receivedAt: time when the SMS was received in the format of YYYY-MM-DD HH:mm:ss
• code: a code from the SMS.
• service: activation service.
• country: activation country.

If you are using third-party software, then ask to add the SMS-Activate webhook. This will speed up the work process.

Any questions regarding API integration will be answered by a specially trained member of our technical support team.