# JSON API

API for sending messages via SMS, Viber, WhatsApp and other communication channels.

## JSON API v2

API key is required for all requests. You can find your API key in your [account settings](https://app.smsmanager.com/api-cloud).

API versions (http-api and xml-api) are deprecated also and you should use this JSON API v2 instead.


Version: v2

## Servers

Responds with your request data
```
https://api.smsmngr.com/v2
```

## Security

### x-api-key

Type: apiKey
In: header
Name: x-api-key

### apikey

Type: apiKey
In: query
Name: apikey

## Download OpenAPI description

[JSON API](https://api-ref.smsmanager.com/_bundle/openapi/en/json/jsonapi_v2.yaml)

## Sending messages

For sending messages use one of the following endpoints.
- `/message` for sending a message up to 10 recipients
- `/messages` for sending multiple messages (up to 10 messages at once)
- `/simple/message` for sending a simple message (GET and POST)


### Send a message

 - [POST /message](https://api-ref.smsmanager.com/openapi/en/json/jsonapi_v2/sending/paths/~1message/post.md): Use this endpoint to send a message to one or more recipients (up to 10 recipients). If you want to use channels other than SMS (Viber, WhatsApp, etc.), you need to use the flow property.

### Send multiple messages

 - [POST /messages](https://api-ref.smsmanager.com/openapi/en/json/jsonapi_v2/sending/paths/~1messages/post.md): Use this endpoint to send batch of identical messages to more recipients (you can set up to 10 recipients per request and up to 10 requests per one API call). That means, that you can send up to 100 recipients per single HTTP API call. If you want to use channels other than SMS (Viber, WhatsApp, etc.), you need to use the flow property. Using this endpoint, you will receive message_id for each of requests (not for each recipient). For get message_id for each recipient, you need to append - to the message_id. More information about message_id you can find in documentation.

### Send a simple message (GET request)

 - [GET /simple/message](https://api-ref.smsmanager.com/openapi/en/json/jsonapi_v2/sending/paths/~1simple~1message/get.md)

### Send a simple message (POST request)

 - [POST /simple/message](https://api-ref.smsmanager.com/openapi/en/json/jsonapi_v2/sending/paths/~1simple~1message/post.md)

## Webhooks

### Sent message webhook

 - [POST sentMessage](https://api-ref.smsmanager.com/openapi/en/json/jsonapi_v2/webhooks/paths/sentmessage/post.md): This webhook sends you information about sent messages. You can use this webhook to save information about sent messages, such as message_id, gateway, timestamp, payload, etc.

### Incoming reply message webhook

 - [POST incomingReplyMessage](https://api-ref.smsmanager.com/openapi/en/json/jsonapi_v2/webhooks/paths/incomingreplymessage/post.md)

### Incoming message webhook

 - [POST incomingMessage](https://api-ref.smsmanager.com/openapi/en/json/jsonapi_v2/webhooks/paths/incomingmessage/post.md)