SMS

pepe.business SMS for sending and receiving SMS/MMS via API.

Send an SMS

POST /v1/sms/send
{
  "from": "+33612345678",
  "to": "+33698765432",
  "text": "Your code is 123456"
}

Response:

{
  "id": "sms_xxx",
  "status": "sent",
  "cost": 0.008,
  "currency": "USD"
}

MMS (image)

POST /v1/sms/send
{
  "from": "+33612345678",
  "to": "+33698765432",
  "text": "Here is your ticket",
  "mediaUrl": "https://example.com/ticket.png"
}

10DLC (US)

To send application SMS in the US, you must register a 10DLC campaign:

POST /v1/sms/10dlc/registration
{
  "brandName": "Acme Corp",
  "useCase": "marketing",
  "sampleMessage": "Acme promo: -20% today only. STOP=optout",
  "optInDescription": "..."
}

Cost: $9 one-time + $4/month per campaign.

Opt-outs

pepe.business automatically manages opt-outs (STOP, UNSUBSCRIBE):

GET /v1/sms/opt-outs?phoneNumberId=phn_xxx

{
  "optOuts": [
    { "phoneNumber": "+13125551234", "reason": "STOP", "timestamp": "..." }
  ]
}

HLR lookup

Check if a number is valid and active:

POST /v1/sms/hlr-lookup
{ "phoneNumber": "+13125551234" }

{
  "valid": true,
  "carrier": "Verizon",
  "country": "US",
  "ported": false
}

Reception

Configure an sms.received webhook. You receive:

{
  "from": "+33698765432",
  "to": "+33612345678",
  "text": "Yes I confirm",
  "receivedAt": "..."
}

Pricing

Limits

• 1 message / 4s per recipient
• 160 characters per segment (70 in Unicode)
• Long messages automatically concatenated (billed per segment)