PindoDocs
Web AppWeb

Inbound SMS

Pindo inbound messaging enables two-way SMS. Configure a webhook URL in the dashboard and receive every message sent to your short or long code.

Webhook events

When someone messages your code, Pindo sends a POST request to your webhook URL with the message payload.

{
  "from": "+25078123456",
  "to": "7878",
  "created_at": "24-07-2020, 23:35:32",
  "sms_id": 1058918,
  "text": "Hello from Pindo",
  "telco": "MTN"
}
FieldDescription
fromSender's phone number.
toYour short or long code that received the message.
textThe message content.
telcoThe originating mobile network, e.g. MTN.
created_atTimestamp the message was received.

List inbound messages

GET/v1/sms/inbounds

Retrieve received messages with pagination metadata.

{
  "inbound_sms": [
    {
      "account_id": 11783,
      "conversation_id": null,
      "created_at": "2022-08-05T12:32:42.196907",
      "id": 20,
      "inbound_sms_number": "+250781113333",
      "text": "Hello world !"
    }
  ],
  "pages": {
    "page": 1,
    "pages": 1,
    "per_page": 20,
    "total": 20
  }
}

Try it

Interactive PlaygroundFetch received inbound messages from your account
cURL
curl -X GET "https://api.pindo.io/v1/sms/inbounds?page=1&per_page=10" \
  -H "Authorization: Bearer YOUR_TOKEN"