# SMS API

> Send SMS and MMS messages to customers using your store's phone number.

- Human documentation: https://www.myrepairapp.com/api-docs/send-sms
- OpenAPI: https://www.myrepairapp.com/openapi.json
- Last updated: 2026-07-30T23:32:54.653Z

# SMS API 

  Send SMS and MMS text messages to your customers using your store's MyRepairApp phone number.

  Messages are sent through your store's existing SMS configuration and draw down your store's SMS credits, exactly like messages sent from within the app.
  
  > **Note:** Your store must have an active SMS subscription with available credits, and completed A2P registration, for messages to be delivered.

  ---

  ## Send a Message

  Sends an SMS to a single phone number. If `mediaUrls` are included, the message is sent as an MMS.

  ### HTTP Request

  ```http
  POST https://www.myrepairapp.com/api/v2/sms/send
  ```

  ### Request Body

  | Field | Type | Required | Description |
  | ----- | ---- | -------- | ----------- |
  | `phone` | `string` | Yes | The destination phone number. Most common formats are accepted and normalized to E.164 (e.g. `+15039969920`). |
  ### Request Body

  | Field | Type | Required | Description |
  | ----- | ---- | -------- | ----------- |
  | `phone` | `string` | Yes | The destination phone number. Most common formats are accepted and normalized to E.164 (e.g. `+15039969920`). |
  | `message` | `string` | Yes | The text body of the message. Maximum 1,600 characters. |
  | `mediaUrls` | `string[]` | No | Publicly accessible URLs of media to attach as an MMS. Maximum of 10. |

  ### Example Request - SMS

  ```bash
  curl -X POST "https://www.myrepairapp.com/api/v2/sms/send" \
    -H "X-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "phone": "+15039969920",
      "message": "Your repair is ready for pickup!"
    }'
  ```

  ### Example Request - MMS

  ```bash
  curl -X POST "https://www.myrepairapp.com/api/v2/sms/send" \
    -H "X-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "phone": "+15039969920",
      "message": "Here is a photo of your device.",
      "mediaUrls": ["https://example.com/device-photo.jpg"]
    }'
  ```

  ### Response

  If successful, the response includes the message identifier and its current delivery status.

  ```json
  {
    "messageSid": "SMd6baeae48b9be910a8bbe0e40fa8e7cb",
    "status": "queued"
  }
  ```

  ---

  ## Error Responses

  | Status | Description |
  | ------ | ----------- |
  | 400 | Invalid request body, or SMS is not configured for your store. |
  | 401 | Unauthorized - missing or invalid API key. |
  | 402 | Your SMS subscription has expired, or you have insufficient credits. |
  | 502 | The message could not be sent due to an upstream provider error. Try again. |

  ```json
  {
    "message": "Insufficient credits, please go to the communication settings page to add more"
  }
  ```