How to Send & Receive SMS with DIDfarm

Overview

DIDfarm SMS lets you send and receive text messages on any SMS-enabled phone number in your account. Messages can be managed through two channels:

• Portal — send and receive messages directly in the DIDfarm dashboard under the SMS tab. No code required.
• REST API — integrate SMS into your application for automated messaging, notifications, and customer engagement.

Inbound SMS is free. Outbound messages are charged per segment from your wallet balance.

How it works

1. Purchase a number with SMS capability (or enable SMS on an existing number)
2. Send outbound SMS from the portal or API
3. Receive inbound SMS in your portal inbox or via webhook
4. Track delivery status in real-time

Prerequisites

• A DIDfarm account with wallet balance (sign up or top up)
• An active phone number in a country that supports SMS (see supported countries)
• For API usage: your API key from the API Keys tab in the portal

Step 1 — Enable SMS on a Number

Option A: During checkout

When ordering new numbers, SMS-capable numbers show an "SMS" checkbox in Step 2 of the order flow. Check the box to enable SMS — the add-on cost is shown next to each number.

Option B: On an existing number

1. Go to My Numbers in the portal
2. Click Configure on the number you want to SMS-enable
3. Find the SMS capability toggle in the settings panel
4. Toggle it on — you'll see the monthly price and a confirmation prompt
5. Confirm — the SMS add-on fee is charged from your wallet

Step 2 — Send SMS from the Portal

The message appears in your SMS inbox immediately with a delivery status indicator. Status updates from queued → sent → delivered in real-time.

Step 3 — View Your SMS Inbox

All inbound and outbound messages appear in the SMS tab of your portal. You can:

• Filter by number — select a specific DID to see only its messages
• Filter by direction — show only inbound or outbound
• View stats — messages today, this month, and 30-day delivery rate

Step 4 — Send SMS via API

Send SMS programmatically using the DIDfarm REST API. Authenticate with your API key in the Authorization header.

{
  "from_number_id": 42,
  "to": "+31612345678",
  "body": "Hello from DIDfarm!"
}

curl -X POST https://didfarm.com/api/v1/portal/sms/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number_id": 42,
    "to": "+31612345678",
    "body": "Your order #1234 has shipped!"
  }'

{
  "success": true,
  "message": {
    "id": 156,
    "direction": "outbound",
    "from": "+31201234567",
    "to": "+31612345678",
    "body": "Your order #1234 has shipped!",
    "status": "queued",
    "segments": 1,
    "carrier": "didfarm",
    "created_at": "2026-04-03T10:15:30.000000Z"
  }
}

Step 5 — Receive SMS via Webhook

To receive inbound SMS in your application, configure a webhook URL. DIDfarm will send an HTTP POST to your endpoint for each incoming message.

{
  "event": "sms.received",
  "data": {
    "id": 157,
    "from": "+31612345678",
    "to": "+31201234567",
    "body": "Thanks, got the tracking!",
    "segments": 1,
    "received_at": "2026-04-03T10:16:45.000000Z"
  }
}

Step 6 — Track Delivery Status

Every outbound message goes through these status transitions:

Check delivery status via the portal SMS tab or by calling:

curl https://didfarm.com/api/v1/portal/sms?direction=outbound \
  -H "Authorization: Bearer YOUR_API_KEY"

Pricing

View full per-country SMS pricing on the SMS product page.

Supported Countries

SMS is available in 40+ countries. The most popular include:

For the complete list, see the SMS pricing table. Countries marked with an SMS badge in the order flow support SMS messaging.

Troubleshooting

FAQ

Can I send SMS to any country?

You can send outbound SMS to most countries worldwide. However, your sending number must be in a country that supports SMS. Some destinations may have higher delivery rates with local numbers.

What is a message segment?

A standard SMS segment is 160 characters using GSM-7 encoding (Latin alphabet). Messages using Unicode characters (emoji, Chinese, Arabic, etc.) are limited to 70 characters per segment. Longer messages are automatically split into multiple segments and reassembled on the recipient's phone.

Can I use SMS with the API only (no portal)?

Yes. The portal and API use the same underlying messaging system. You can send via API and view history in the portal, or use the API exclusively.

Is there a rate limit?

Default rate limit is 10 messages per second per account. Contact us for higher throughput if you need bulk messaging.

Do you support MMS (picture messages)?

MMS is on our roadmap and will be available on US and Canadian numbers first. Currently, only text SMS is supported.