Skip to main content
Reteno logo
  • Category: marketing automation
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 14
  • Triggers: 0
  • Slug: RETENO
  • Version: 20261101_00

Tools

Slug: RETENO_GET_ACCOUNT_BALANCEReturn monetary balance, credit limit, currency, and remaining prepaid email and SMS quotas for the connected Reteno 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: RETENO_GET_ACCOUNT_INFOReturn the Reteno organization and API user associated with the connected account. Use this to verify which account subsequent operations affect.

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: RETENO_GET_CONTACTReturn the full Reteno profile for one contact identified by its internal contact ID.

Input Parameters

integer
required
Reteno internal contact ID, obtainable from Search Contacts.

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: RETENO_GET_CONTACT_IMPORT_STATUSReturn the current state and resulting contact IDs for an asynchronous Reteno contact import started by Upsert Contacts.

Input Parameters

string
required
Asynchronous session ID returned by Upsert Contacts.

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: RETENO_LIST_ADDRESS_BOOKSReturn Reteno contact address books and their assigned field groups and fields.

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: RETENO_LIST_CONTACT_FIELDSList custom contact fields, their field IDs and keys, data types, allowed values, and validation metadata.

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: RETENO_LIST_CONTACT_MESSAGESReturn one page of a contact’s email, SMS, push, web push, or App Inbox message history for a required date range.

Input Parameters

string
Contact email address. Provide exactly one contact selector.
string
Contact phone number. Provide exactly one contact selector.
string
Opaque continuation cursor from a previous response. Omit for the first page.
string
required
End of the history period in YYYY-MM-DD or YYYY-MM-DDTHH:mm format.
integer
Maximum history items in this page (1-100).
string
required
Start of the history period in YYYY-MM-DD or YYYY-MM-DDTHH:mm format.
integer
Reteno internal contact ID. Provide exactly one contact selector.
array
Optional channel filters: email, sms, mobilepush, webpush, or appinbox.
string
External customer ID. Provide exactly one contact selector.

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: RETENO_LIST_CONTACTSList one bounded page of Reteno contacts. Optionally filter by external customer ID, email, phone, or name.

Input Parameters

string
Email address to match.
string
SMS phone number to match.
string
Opaque continuation cursor from a previous response. Omit for the first page.
integer
Maximum contacts in this page (1-500). Keep this bounded because contacts may contain personal data.
string
Contact last name to match.
string
Contact first name to match.
boolean
Sort an unfiltered scan by contact ID for stable bulk traversal.
string
Exact external customer ID to match.

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: RETENO_LIST_SEGMENTSSearch Reteno contact segments by name and return one bounded page with segment IDs and types.

Input Parameters

string
Optional segment name filter.
string
Opaque continuation cursor from a previous response. Omit for the first page.
integer
Maximum segments in this page (1-500).

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: RETENO_LIST_SUBSCRIPTION_CATEGORIESList the organization’s contact subscription categories and the keys used to manage communication preferences.

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: RETENO_LIST_WORKFLOWSSearch Reteno automation workflows by name and return their IDs, status, and tags.

Input Parameters

string
Optional workflow name filter.
string
Opaque continuation cursor from a previous response. Omit for the first page.
integer
Maximum workflows in this page (1-500).

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: RETENO_TRACK_EVENTSend one backend event for an identified contact. A new event type key is created after Reteno accepts its first event.

Input Parameters

string
Contact email address. Provide at least one contact identifier.
string
Contact phone number. Provide at least one contact identifier.
integer
Reteno internal contact ID. Provide at least one contact identifier.
string
Web or mobile push token. Provide at least one contact identifier.
string
required
Reteno event type key. A new key creates an event type after Reteno accepts the first event.
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.
string
External customer ID. Provide at least one contact identifier; this is the recommended identifier.

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: RETENO_UPSERT_CONTACTCreate or update a Reteno contact in real time and return its Reteno contact ID.

Input Parameters

array
Custom field values to set on the contact.
object
Contact postal address.
array
Contact channels, each containing a type and value. Provide this or external_customer_id; at least one is required.
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.
string
Market or region identifier using letters, numbers, hyphen, or underscore (maximum 64 characters).
string
IANA contact time zone, for example Europe/London.
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.
string
Contact language code.
integer
Address book ID from List Address Books.
string
Stable contact ID from your system. Provide this or channels; at least one is required. Recommended for deterministic upserts.

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: RETENO_UPSERT_CONTACTSCreate or update 1-3000 Reteno contacts asynchronously using one explicit deduplication strategy. Returns an import session ID and immediate failures.

Input Parameters

array
required
Contacts to create or update asynchronously (1-3000).
integer
Custom field ID used for deduplication when dedupe_on is field_id.
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.
array
Static segments to add the contacts to.
array
Contact fields to update. If omitted, Reteno updates every field and may set omitted values to null.
boolean
Whether to restore matching previously deleted contacts.
array
Custom field IDs to update when contacts include custom field values.
array
Static segments to remove the contacts from.

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