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

# Reteno

> Reteno is a customer engagement platform for managing contacts, behavioral events, messaging campaigns, and omnichannel communications.

![Reteno logo](https://mintcdn.com/composio-preview/YYC5iurbUCUzEs77/images/toolkits/reteno.svg?fit=max\&auto=format\&n=YYC5iurbUCUzEs77\&q=85\&s=9cb0d3145c35e581df932eb7b82661b1)

* **Category:** marketing automation
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 14
* **Triggers:** 0
* **Slug:** `RETENO`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Account Balance
>
> **Slug:** `RETENO_GET_ACCOUNT_BALANCE`
>
> Return monetary balance, credit limit, currency, and remaining prepaid email and SMS quotas for the connected Reteno 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 Account Info
>
> **Slug:** `RETENO_GET_ACCOUNT_INFO`
>
> Return the Reteno organization and API user associated with the connected account. Use this to verify which account subsequent operations affect.
>
> #### 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 Contact
>
> **Slug:** `RETENO_GET_CONTACT`
>
> Return the full Reteno profile for one contact identified by its internal contact ID.
>
> #### Input Parameters
>
> **contact\_id** `integer` *required*
>
> Reteno internal contact ID, obtainable from Search Contacts.
>
> #### 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 Contact Import Status
>
> **Slug:** `RETENO_GET_CONTACT_IMPORT_STATUS`
>
> Return the current state and resulting contact IDs for an asynchronous Reteno contact import started by Upsert Contacts.
>
> #### Input Parameters
>
> **session\_id** `string` *required*
>
> Asynchronous session ID returned by Upsert Contacts.
>
> #### 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 Address Books
>
> **Slug:** `RETENO_LIST_ADDRESS_BOOKS`
>
> Return Reteno contact address books and their assigned field groups and fields.
>
> #### 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 Fields
>
> **Slug:** `RETENO_LIST_CONTACT_FIELDS`
>
> List custom contact fields, their field IDs and keys, data types, allowed values, and validation metadata.
>
> #### 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 Messages
>
> **Slug:** `RETENO_LIST_CONTACT_MESSAGES`
>
> Return one page of a contact's email, SMS, push, web push, or App Inbox message history for a required date range.
>
> #### Input Parameters
>
> **email** `string`
>
> Contact email address. Provide exactly one contact selector.
>
> **phone** `string`
>
> Contact phone number. Provide exactly one contact selector.
>
> **cursor** `string`
>
> Opaque continuation cursor from a previous response. Omit for the first page.
>
> **date\_to** `string` *required*
>
> End of the history period in YYYY-MM-DD or YYYY-MM-DDTHH:mm format.
>
> **max\_rows** `integer`
>
> Maximum history items in this page (1-100).
>
> **date\_from** `string` *required*
>
> Start of the history period in YYYY-MM-DD or YYYY-MM-DDTHH:mm format.
>
> **contact\_id** `integer`
>
> Reteno internal contact ID. Provide exactly one contact selector.
>
> **channel\_types** `array`
>
> Optional channel filters: email, sms, mobilepush, webpush, or appinbox.
>
> **external\_customer\_id** `string`
>
> External customer ID. Provide exactly one contact selector.
>
> #### 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:** `RETENO_LIST_CONTACTS`
>
> List one bounded page of Reteno contacts. Optionally filter by external customer ID, email, phone, or name.
>
> #### Input Parameters
>
> **email** `string`
>
> Email address to match.
>
> **phone** `string`
>
> SMS phone number to match.
>
> **cursor** `string`
>
> Opaque continuation cursor from a previous response. Omit for the first page.
>
> **max\_rows** `integer`
>
> Maximum contacts in this page (1-500). Keep this bounded because contacts may contain personal data.
>
> **last\_name** `string`
>
> Contact last name to match.
>
> **first\_name** `string`
>
> Contact first name to match.
>
> **sort\_by\_contact\_id** `boolean`
>
> Sort an unfiltered scan by contact ID for stable bulk traversal.
>
> **external\_customer\_id** `string`
>
> Exact external customer ID to match.
>
> #### 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 Segments
>
> **Slug:** `RETENO_LIST_SEGMENTS`
>
> Search Reteno contact segments by name and return one bounded page with segment IDs and types.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional segment name filter.
>
> **cursor** `string`
>
> Opaque continuation cursor from a previous response. Omit for the first page.
>
> **max\_rows** `integer`
>
> Maximum segments in this page (1-500).
>
> #### 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 Subscription Categories
>
> **Slug:** `RETENO_LIST_SUBSCRIPTION_CATEGORIES`
>
> List the organization's contact subscription categories and the keys used to manage communication preferences.
>
> #### 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 Workflows
>
> **Slug:** `RETENO_LIST_WORKFLOWS`
>
> Search Reteno automation workflows by name and return their IDs, status, and tags.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional workflow name filter.
>
> **cursor** `string`
>
> Opaque continuation cursor from a previous response. Omit for the first page.
>
> **max\_rows** `integer`
>
> Maximum workflows in this page (1-500).
>
> #### 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] Track Event
>
> **Slug:** `RETENO_TRACK_EVENT`
>
> Send one backend event for an identified contact. A new event type key is created after Reteno accepts its first event.
>
> #### Input Parameters
>
> **email** `string`
>
> Contact email address. Provide at least one contact identifier.
>
> **phone** `string`
>
> Contact phone number. Provide at least one contact identifier.
>
> **contact\_id** `integer`
>
> Reteno internal contact ID. Provide at least one contact identifier.
>
> **push\_token** `string`
>
> Web or mobile push token. Provide at least one contact identifier.
>
> **event\_type\_key** `string` *required*
>
> Reteno event type key. A new key creates an event type after Reteno accepts the first event.
>
> **event\_parameters** `object`
>
> Optional event-specific parameters required by this event type. Values may be strings, numbers, booleans, or nested objects and arrays (for example cart line items). Do not include contact identifiers here.
>
> **external\_customer\_id** `string`
>
> External customer ID. Provide at least one contact identifier; this is the recommended identifier.
>
> #### 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] Upsert Contact
>
> **Slug:** `RETENO_UPSERT_CONTACT`
>
> Create or update a Reteno contact in real time and return its Reteno contact ID.
>
> #### Input Parameters
>
> **fields** `array`
>
> Custom field values to set on the contact.
>
> **address** `object`
>
> Contact postal address.
>
> **channels** `array`
>
> Contact channels, each containing a type and value. Provide this or external\_customer\_id; at least one is required.
>
> **last\_name** `string`
>
> Contact last name (maximum 40 characters and 3 digits). Use letters; Reteno permits apostrophes and hyphens only within words and a trailing period only on a word of up to 3 characters.
>
> **market\_id** `string`
>
> Market or region identifier using letters, numbers, hyphen, or underscore (maximum 64 characters).
>
> **time\_zone** `string`
>
> IANA contact time zone, for example Europe/London.
>
> **first\_name** `string`
>
> Contact first name (maximum 40 characters and 3 digits). Use letters; Reteno permits apostrophes and hyphens only within words and a trailing period only on a word of up to 3 characters.
>
> **language\_code** `string`
>
> Contact language code.
>
> **address\_book\_id** `integer`
>
> Address book ID from List Address Books.
>
> **external\_customer\_id** `string`
>
> Stable contact ID from your system. Provide this or channels; at least one is required. Recommended for deterministic upserts.
>
> #### 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] Upsert Contacts
>
> **Slug:** `RETENO_UPSERT_CONTACTS`
>
> Create or update 1-3000 Reteno contacts asynchronously using one explicit deduplication strategy. Returns an import session ID and immediate failures.
>
> #### Input Parameters
>
> **contacts** `array` *required*
>
> Contacts to create or update asynchronously (1-3000).
>
> **field\_id** `integer`
>
> Custom field ID used for deduplication when dedupe\_on is field\_id.
>
> **dedupe\_on** `string ("email" | "sms" | "push" | "email_or_sms" | "id" | "external_customer_id" | "field_id")` *required*
>
> Field Reteno uses to identify existing contacts. A contact's external\_customer\_id takes precedence when present.
>
> **group\_names** `array`
>
> Static segments to add the contacts to.
>
> **contact\_fields** `array`
>
> Contact fields to update. If omitted, Reteno updates every field and may set omitted values to null.
>
> **restore\_deleted** `boolean`
>
> Whether to restore matching previously deleted contacts.
>
> **custom\_field\_ids** `array`
>
> Custom field IDs to update when contacts include custom field values.
>
> **excluded\_group\_names** `array`
>
> Static segments to remove the contacts from.
>
> #### 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
