> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Seven.io

> Seven.io provides APIs for SMS, voice, messaging, contacts, phone-number management, and communication analytics.

![Seven.io logo](https://mintcdn.com/composio-preview/B09iGux45A5cYDuO/images/toolkits/seven_io.svg?fit=max\&auto=format\&n=B09iGux45A5cYDuO\&q=85\&s=0aa912d52328a012119b72007d695747)

* **Category:** phone & sms
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 11
* **Triggers:** 0
* **Slug:** `SEVEN_IO`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Contact
>
> **Slug:** `SEVEN_IO_CREATE_CONTACT`
>
> Create a Seven.io contact with identity, address, phone, notes, and group fields.
>
> #### Input Parameters
>
> **city** `string`
>
> Contact city.
>
> **email** `string`
>
> Contact email address.
>
> **notes** `string`
>
> Free-form contact notes.
>
> **address** `string`
>
> Contact street address.
>
> **birthday** `string`
>
> Contact birthday in the format accepted by Seven.io, such as YYYY-MM-DD.
>
> **group\_ids** `array`
>
> Existing Seven.io group IDs to assign to the contact.
>
> **last\_name** `string`
>
> Contact's last name.
>
> **first\_name** `string`
>
> Contact's first name.
>
> **home\_number** `string`
>
> Contact home phone number.
>
> **postal\_code** `string`
>
> Contact postal code.
>
> **mobile\_number** `string`
>
> Contact mobile number, preferably in international format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact
>
> **Slug:** `SEVEN_IO_DELETE_CONTACT`
>
> Permanently delete one Seven.io contact by ID. This is destructive and cannot be undone.
>
> #### Input Parameters
>
> **contact\_id** `integer` *required*
>
> ID of the contact to permanently delete. Confirm the intended contact before calling.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Format Phone Numbers
>
> **Slug:** `SEVEN_IO_FORMAT_PHONE_NUMBERS`
>
> Validate and normalize one or more phone numbers without performing a paid carrier lookup.
>
> #### Input Parameters
>
> **numbers** `array` *required*
>
> Phone numbers to validate and format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Analytics
>
> **Slug:** `SEVEN_IO_GET_ANALYTICS`
>
> Return Seven.io usage statistics for a date range, optionally grouped by date, label, subaccount, or country.
>
> #### Input Parameters
>
> **end** `string`
>
> Inclusive end date in YYYY-MM-DD format.
>
> **label** `string`
>
> Restrict statistics to this message label.
>
> **start** `string`
>
> Inclusive start date in YYYY-MM-DD format.
>
> **group\_by** `string ("date" | "label" | "subaccount" | "country")`
>
> Dimension used to group the statistics.
>
> **subaccounts** `string`
>
> Use only\_main, all, or a specific subaccount ID. This filters reporting only and does not route the authenticated account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Balance
>
> **Slug:** `SEVEN_IO_GET_BALANCE`
>
> Return the connected Seven.io account's available credit balance and currency.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get SMS Pricing
>
> **Slug:** `SEVEN_IO_GET_SMS_PRICING`
>
> Return Seven.io SMS prices, preferably narrowed to one destination country.
>
> #### Input Parameters
>
> **country** `string`
>
> ISO 3166-1 alpha-2 destination country code, such as DE. Omit only when pricing for all countries is needed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `SEVEN_IO_LIST_CONTACTS`
>
> List or search one page of Seven.io contacts, optionally restricted to a contact group. Pagination details indicate whether more contacts are available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum contacts to return (30-500).
>
> **offset** `integer`
>
> Zero-based result offset. Increase it by the returned paging count while paging.has\_more is true.
>
> **search** `string`
>
> Search text for matching contacts.
>
> **group\_id** `integer`
>
> Return only contacts in this group ID.
>
> **order\_by** `string`
>
> Contact field used for sorting.
>
> **order\_direction** `string ("asc" | "desc")`
>
> Sort direction.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contact Groups
>
> **Slug:** `SEVEN_IO_LIST_GROUPS`
>
> List one page of Seven.io contact groups and their member counts for use in contact filtering or assignment. Pagination details indicate whether more groups are available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum groups to return. Defaults to Seven.io's own page size of 10; raise it for larger pages.
>
> **offset** `integer`
>
> Zero-based result offset. While paging.has\_more is true, continue with paging.offset plus paging.count.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Message Journal
>
> **Slug:** `SEVEN_IO_QUERY_MESSAGE_JOURNAL`
>
> Query one page of outbound SMS, inbound SMS, or voice journal entries using a consistent filter interface.
>
> #### Input Parameters
>
> **to** `string`
>
> Destination-number filter.
>
> **limit** `integer`
>
> Maximum journal entries to return (1-100).
>
> **state** `string`
>
> Provider journal state filter.
>
> **offset** `integer`
>
> Zero-based result offset. While has\_more is true, use the returned next\_offset for the following page.
>
> **date\_to** `string`
>
> Inclusive end date in YYYY-MM-DD format.
>
> **date\_from** `string`
>
> Inclusive start date in YYYY-MM-DD format.
>
> **message\_id** `integer`
>
> Restrict results to this provider message ID.
>
> **journal\_type** `string ("outbound" | "inbound" | "voice")` *required*
>
> Journal to query: outbound SMS, inbound SMS, or voice. The replies journal is intentionally unavailable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send SMS
>
> **Slug:** `SEVEN_IO_SEND_SMS`
>
> Send an SMS through Seven.io; live calls contact external recipients and are billable, while sandbox calls validate without dispatching messages or consuming paid products. A returned result can include failed recipients, so inspect per-recipient results.
>
> #### Input Parameters
>
> **to** `array` *required*
>
> Recipient phone numbers, contact names or IDs, or group names or IDs. Each entry is sent as one recipient.
>
> **ttl** `integer`
>
> Delivery time-to-live in minutes. The default is 2880 (48 hours).
>
> **from** `string`
>
> Sender ID or approved sender number. Seven.io permits up to 11 alphanumeric or 16 numeric characters; a numeric sender may be given in international format with a leading plus.
>
> **text** `string` *required*
>
> SMS body, up to 1520 characters. Long messages may be split into multiple billable parts.
>
> **delay** `string`
>
> Future dispatch time as a Unix timestamp or YYYY-MM-DD hh:mm:ss. Omit to send immediately.
>
> **flash** `boolean`
>
> Send as a flash SMS, which supported devices display immediately.
>
> **label** `string`
>
> Tracking label of at most 100 characters using letters, digits, dot, hyphen, underscore, or @.
>
> **foreign\_id** `string`
>
> Caller-defined correlation ID of at most 64 characters using letters, digits, dot, hyphen, underscore, or @.
>
> **get\_replies** `boolean`
>
> Enable Seven.io reply handling for 48 hours when supported by the account.
>
> **performance\_tracking** `boolean`
>
> Enable Seven.io URL shortening and performance tracking for links in the message.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact
>
> **Slug:** `SEVEN_IO_UPDATE_CONTACT`
>
> Update selected standard fields or group memberships on an existing Seven.io contact.
>
> #### Input Parameters
>
> **city** `string`
>
> Replacement city.
>
> **email** `string`
>
> Replacement email address.
>
> **notes** `string`
>
> Replacement contact notes.
>
> **address** `string`
>
> Replacement street address.
>
> **birthday** `string`
>
> Replacement birthday in the format accepted by Seven.io, such as YYYY-MM-DD.
>
> **group\_ids** `array`
>
> Replacement group memberships. Provide at least one existing Seven.io group ID.
>
> **last\_name** `string`
>
> Replacement last name.
>
> **contact\_id** `integer` *required*
>
> ID of the contact to update.
>
> **first\_name** `string`
>
> Replacement first name.
>
> **home\_number** `string`
>
> Replacement home number.
>
> **postal\_code** `string`
>
> Replacement postal code.
>
> **mobile\_number** `string`
>
> Replacement mobile number, preferably in international format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
