📲SMS Magic

Provider Code: sms_magic Service: Sms

Overview

Global SMS provider with multi-country support and webhooks.

Services Supported

• ✅ Sms

Configuration

Config Class: SMSMagicConfig

To use SMS Magic, configure it in Templater UI:

1. Navigate to Company/User settings

2. Select "Sms" service

3. Add "SMS Magic" provider

4. Enter required credentials

V1 Note: Configuration UI documentation is deferred to V2. For now, configure providers via Templater UI, then use them via API.

Usage Example

curl

curl -X POST https://api.docs-dispatcher.io/api/sms \
  -H "Authorization: Bearer $JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "providerName": "sms_magic",
    "template": {
      "id": 123,
      "data": {
        // Your template data
      }
    }
  }'

Node.js

const response = await fetch('https://api.docs-dispatcher.io/api/sms', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${jwtToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    providerName: 'sms_magic',
    template: {
      id: 123,
      data: { /* Your template data */ }
    }
  })
});

const result = await response.json();
console.log(result);

Common Errors

Provider Not Configured (400)

{
  "error": "provider_not_configured",
  "message": "SMS Magic is not configured for this user or company"
}

Solution: Configure SMS Magic in Templater UI.

Invalid Credentials (401)

{
  "error": "provider_authentication_failed",
  "message": "SMS Magic credentials are invalid or expired"
}

Solution: Update SMS Magic credentials in configuration.

Next Steps

• Configure SMS Magic

• Sms service overview

• SMS dispatch guide

• All providers