Skip to main content
Seven.io logo
  • Category: phone & sms
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: SEVEN_IO
  • Version: 20261101_00

Tools

Slug: SEVEN_IO_CREATE_CONTACTCreate a Seven.io contact with identity, address, phone, notes, and group fields.

Input Parameters

string
Contact city.
string
Contact email address.
string
Free-form contact notes.
string
Contact street address.
string
Contact birthday in the format accepted by Seven.io, such as YYYY-MM-DD.
array
Existing Seven.io group IDs to assign to the contact.
string
Contact’s last name.
string
Contact’s first name.
string
Contact home phone number.
string
Contact postal code.
string
Contact mobile number, preferably in international format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_DELETE_CONTACTPermanently delete one Seven.io contact by ID. This is destructive and cannot be undone.

Input Parameters

integer
required
ID of the contact to permanently delete. Confirm the intended contact before calling.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_FORMAT_PHONE_NUMBERSValidate and normalize one or more phone numbers without performing a paid carrier lookup.

Input Parameters

array
required
Phone numbers to validate and format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_GET_ANALYTICSReturn Seven.io usage statistics for a date range, optionally grouped by date, label, subaccount, or country.

Input Parameters

string
Inclusive end date in YYYY-MM-DD format.
string
Restrict statistics to this message label.
string
Inclusive start date in YYYY-MM-DD format.
string ("date" | "label" | "subaccount" | "country")
Dimension used to group the statistics.
string
Use only_main, all, or a specific subaccount ID. This filters reporting only and does not route the authenticated account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_GET_BALANCEReturn the connected Seven.io account’s available credit balance and currency.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_GET_SMS_PRICINGReturn Seven.io SMS prices, preferably narrowed to one destination country.

Input Parameters

string
ISO 3166-1 alpha-2 destination country code, such as DE. Omit only when pricing for all countries is needed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_LIST_CONTACTSList or search one page of Seven.io contacts, optionally restricted to a contact group. Pagination details indicate whether more contacts are available.

Input Parameters

integer
Maximum contacts to return (30-500).
integer
Zero-based result offset. Increase it by the returned paging count while paging.has_more is true.
Search text for matching contacts.
integer
Return only contacts in this group ID.
string
Contact field used for sorting.
string ("asc" | "desc")
Sort direction.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_LIST_GROUPSList 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

integer
Maximum groups to return. Defaults to Seven.io’s own page size of 10; raise it for larger pages.
integer
Zero-based result offset. While paging.has_more is true, continue with paging.offset plus paging.count.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_QUERY_MESSAGE_JOURNALQuery one page of outbound SMS, inbound SMS, or voice journal entries using a consistent filter interface.

Input Parameters

string
Destination-number filter.
integer
Maximum journal entries to return (1-100).
string
Provider journal state filter.
integer
Zero-based result offset. While has_more is true, use the returned next_offset for the following page.
string
Inclusive end date in YYYY-MM-DD format.
string
Inclusive start date in YYYY-MM-DD format.
integer
Restrict results to this provider message ID.
string ("outbound" | "inbound" | "voice")
required
Journal to query: outbound SMS, inbound SMS, or voice. The replies journal is intentionally unavailable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_SEND_SMSSend 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

array
required
Recipient phone numbers, contact names or IDs, or group names or IDs. Each entry is sent as one recipient.
integer
Delivery time-to-live in minutes. The default is 2880 (48 hours).
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.
string
required
SMS body, up to 1520 characters. Long messages may be split into multiple billable parts.
string
Future dispatch time as a Unix timestamp or YYYY-MM-DD hh:mm:ss. Omit to send immediately.
boolean
Send as a flash SMS, which supported devices display immediately.
string
Tracking label of at most 100 characters using letters, digits, dot, hyphen, underscore, or @.
string
Caller-defined correlation ID of at most 64 characters using letters, digits, dot, hyphen, underscore, or @.
boolean
Enable Seven.io reply handling for 48 hours when supported by the account.
boolean
Enable Seven.io URL shortening and performance tracking for links in the message.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEVEN_IO_UPDATE_CONTACTUpdate selected standard fields or group memberships on an existing Seven.io contact.

Input Parameters

string
Replacement city.
string
Replacement email address.
string
Replacement contact notes.
string
Replacement street address.
string
Replacement birthday in the format accepted by Seven.io, such as YYYY-MM-DD.
array
Replacement group memberships. Provide at least one existing Seven.io group ID.
string
Replacement last name.
integer
required
ID of the contact to update.
string
Replacement first name.
string
Replacement home number.
string
Replacement postal code.
string
Replacement mobile number, preferably in international format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not