# Mocean

Mocean enables SMS, voice, and verification services, integrating messaging capabilities into applications for multifactor authentication or customer engagement

- **Category:** phone & sms
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `MOCEAN`
- **Version:** 20260211_00

## Tools

### Query SMS Message Status V2

**Slug:** `MOCEAN_QUERY_MESSAGE_STATUS_V2`

Tool to query delivery status of an SMS message. Use after sending an SMS when you need to check its delivery success by msgid.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mocean-msgid` | string | Yes | Message ID returned when the SMS was submitted |
| `mocean-api-key` | string | Yes | Your Mocean API key. |
| `mocean-api-secret` | string | Yes | Your Mocean API secret. |
| `mocean-resp-format` | string ("JSON" | "XML") | No | Response format. Supported: JSON, XML. Defaults to JSON. |

#### 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 |

### Voice Dial V2

**Slug:** `MOCEAN_VOICE_DIAL_V2`

Tool to initiate an outbound voice call via Mocean API. Use when you need to place a call with a defined command flow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mocean-to` | string | Yes | Recipient phone number(s) in international format without '+'; separate multiple numbers with space or comma. |
| `mocean-from` | string | No | Caller ID (originating number). |
| `mocean-command` | string | Yes | JSON-encoded array defining the call flow (e.g., play, say, collect, dial). |
| `mocean-event-url` | string | No | Webhook URL to receive call status events. |
| `mocean-resp-format` | string | No | Response format. Only JSON is supported. |

#### 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 |

### Voice Download Recording V2

**Slug:** `MOCEAN_VOICE_DOWNLOAD_RECORDING_V2`

Tool to download a call recording. Use when you need to retrieve the recording audio for a completed call by its UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mocean-call-uuid` | string | Yes | Call UUID of the recording to download. |

#### 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 |

### Voice Hangup V2

**Slug:** `MOCEAN_VOICE_HANGUP_V2`

Tool to hang up an active voice call. Use when you need to terminate an ongoing call by its call UUID immediately.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mocean-api-key` | string | Yes | Your Mocean API key. |
| `mocean-call-uuid` | string | Yes | The call UUID of the active call to hang up. |
| `mocean-api-secret` | string | Yes | Your Mocean API secret. |
| `mocean-resp-format` | string ("xml" | "json") | No | Response format; xml or json (default json). |

#### 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 |

### WhatsApp Incoming Webhook V2

**Slug:** `MOCEAN_WHATSAPP_INCOMING_WEBHOOK_V2`

Tool to receive and return the full incoming WhatsApp webhook payload. Use when you must capture raw webhook JSON (message_id, event_type, event_data) for downstream parsing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_data` | object | Yes | Complete detail payload of the incoming WhatsApp message |
| `event_type` | string | Yes | Type of the event, must be 'message' |
| `message_id` | string | Yes | Identifier for the incoming message |

#### 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 |

### WhatsApp Send Message V2

**Slug:** `MOCEAN_WHATS_APP_SEND_MESSAGE_V2`

Tool to send a WhatsApp message via Mocean API. Use when you need to send text, media, template, reaction, or interactive messages on WhatsApp.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mocean-to` | string | Yes | Destination WhatsApp number, with country code. |
| `mocean-from` | string | Yes | Registered WhatsApp Business sender number, with country code (e.g., 60123456789). |
| `mocean-content` | object | Yes | Content object of the message (e.g., text, media, template, reaction, interactive). |
| `mocean-event-url` | string | No | Optional webhook URL for delivery events. |

#### 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 |