---
canonical_url: "https://docs.composio.dev/toolkits/labsmobile"
markdown_url: "https://docs.composio.dev/toolkits/labsmobile.md"
product: "platform"
version: null
last_updated: null
---

# LabsMobile

LabsMobile provides APIs for sending SMS messages and retrieving account balances and country pricing.

- **Category:** phone & sms
- **Auth:** BASIC
- **Composio-managed OAuth available?** N/A
- **Tools:** 4
- **Triggers:** 0
- **Slug:** `LABSMOBILE`
- **Version:** 00000000_00

## Tools

### Get Balance

**Slug:** `LABSMOBILE_GET_BALANCE`

Return the connected LabsMobile account's available SMS credits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get SMS Prices

**Slug:** `LABSMOBILE_GET_SMS_PRICES`

Return current SMS credit prices for selected ISO country codes, or for all countries when no codes are supplied.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `country_codes` | array | No | ISO country codes to price, such as ["ES", "US"]; omit to return all available countries. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send SMS

**Slug:** `LABSMOBILE_SEND_SMS`

Submit one or more real SMS messages for immediate processing, which may consume credits and trigger a configured delivery callback. A successful result confirms acceptance, not recipient delivery.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label` | string | No | Optional metadata label of at most 255 characters for identifying the send in LabsMobile history. |
| `sender` | string | No | Optional sender ID: up to 16 digits when numeric or 11 characters when alphanumeric, subject to destination rules. |
| `message` | string | Yes | SMS text to submit; enable unicode or long-message handling when the content requires it. |
| `unicode` | boolean | No | Enable UCS-2 encoding for message characters outside the GSM 03.38 alphabet. |
| `recipients` | array | Yes | Recipient phone numbers in E.164 format, including the country code; accepts 1 to 10,000 numbers. |
| `client_reference` | string | No | Optional caller-defined request identifier of at most 20 characters; LabsMobile assigns one when omitted. |
| `allow_long_message` | boolean | No | Allow the message to be split into concatenated SMS segments when it exceeds one segment. |
| `delivery_callback_url` | string | No | Optional HTTPS URL where LabsMobile sends asynchronous delivery or error status callbacks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Simulate SMS

**Slug:** `LABSMOBILE_SIMULATE_SMS`

Validate one or more SMS submissions without delivery or credit use. The simulation creates an entry in LabsMobile history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label` | string | No | Optional metadata label of at most 255 characters for identifying the send in LabsMobile history. |
| `sender` | string | No | Optional sender ID: up to 16 digits when numeric or 11 characters when alphanumeric, subject to destination rules. |
| `message` | string | Yes | SMS text to submit; enable unicode or long-message handling when the content requires it. |
| `unicode` | boolean | No | Enable UCS-2 encoding for message characters outside the GSM 03.38 alphabet. |
| `recipients` | array | Yes | Recipient phone numbers in E.164 format, including the country code; accepts 1 to 10,000 numbers. |
| `client_reference` | string | No | Optional caller-defined request identifier of at most 20 characters; LabsMobile assigns one when omitted. |
| `allow_long_message` | boolean | No | Allow the message to be split into concatenated SMS segments when it exceeds one segment. |
| `delivery_callback_url` | string | No | Optional HTTPS URL where LabsMobile sends asynchronous delivery or error status callbacks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |