Skip to main content
Engage logo
  • Category: marketing automation
  • Auth: BASIC
  • Composio-managed OAuth available? N/A
  • Tools: 22
  • Triggers: 0
  • Slug: ENGAGE
  • Version: 20261030_00

Tools

Slug: ENGAGE_ADD_CUSTOMER_TO_ACCOUNTSTool to add a customer to one or more account entities. Use when you need to associate a user with accounts and optionally assign roles.

Input Parameters

string
required
User ID of the customer to add to accounts
array
required
Array of accounts to add the customer to, each with account ID and optional role

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: ENGAGE_ADD_USER_TO_LISTSTool to add a Customer or Account to one or more Lists in Engage.so. Use when you need to subscribe a user to specific lists for targeted messaging.

Input Parameters

string
required
User ID of the Customer or Account to add to lists
array
required
Array of list IDs to add the user to. Each ID should be a valid list 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: ENGAGE_ARCHIVE_LISTTool to archive a List in Engage. Use when you want to prevent new subscribers from being added to a list. Existing subscribers will not be affected.

Input Parameters

string
required
The List ID to archive

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: ENGAGE_ARCHIVE_USERTool to archive a user in Engage. Use when you need to deactivate a user account while preserving all historical data. The user will stop being active and all engagement and events for the user will be stopped, but all messages, logs, and related data will be preserved.

Input Parameters

string
required
User ID of the Customer or Account to archive.

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: ENGAGE_CONVERT_USER_TYPETool to convert a user between Customer and Account entity types. Use when you need to change a customer to an account or vice versa.

Input Parameters

string
required
User ID of the Customer or Account to convert.
string ("customer" | "account")
required
The entity type to convert to: customer or 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: ENGAGE_CREATE_LISTTool to create a new List in Engage for organizing subscribers. Use when you need to set up a new list for managing contacts or subscribers.

Input Parameters

string
required
List title (required)
string
String attached to the object - a description or summary of the list
boolean
If true, subscribers receive a confirmation mail before being added to the list
string
URL to redirect users to after subscription

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: ENGAGE_CREATE_USERTool to create a new user (Customer or Account) in Engage. Use when you need to add a user with optional metadata, device tokens, or list subscriptions.

Input Parameters

string
required
Unique identifier for the user in your application. This will be returned as ‘uid’ in the response.
object
Object containing additional custom user attributes (string, number, or boolean values)
string
User’s email address for communication
array
Array of List IDs to automatically subscribe the user to
string
User’s phone number in international format (e.g., +1234567890)
array
Array of account assignments with ID and optional role
string
User’s last name
string
Date the user signed up. Should be a valid ISO 8601 date string
string
User’s first name
boolean
If true, creates the user as an Account entity instead of a regular Customer
string
Device token for push notifications
string
Device platform for push notifications. Must be ‘android’ or ‘ios’

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: ENGAGE_DELETE_SUBSCRIBER_FROM_LISTTool to remove a subscriber from a List entirely (different from unsubscribing). Use when you need to completely delete a subscriber’s association with a specific list.

Input Parameters

string
required
The List ID from which to remove the subscriber
string
required
The subscriber’s unique user ID to remove from the list

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: ENGAGE_DELETE_USERTool to completely delete all user data for a Customer or Account. This is a permanent, destructive action that removes all associated user data from Engage.

Input Parameters

string
required
User ID of the Customer or Account to delete. This is the ID you supplied when creating the user, not Engage’s internal ID.

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: ENGAGE_GET_ACCOUNT_MEMBERSTool to retrieve all members (Customers) of an Account in Engage. Use when you need to list users who are part of a specific account.

Input Parameters

string
required
User ID of the Account whose members to retrieve.

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: ENGAGE_GET_LISTTool to retrieve a single List by its ID. Use when you need to fetch details about a specific List.

Input Parameters

string
required
The unique identifier of the List to retrieve

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: ENGAGE_GET_USERTool to retrieve a single user by their user ID. Use when you need to fetch complete user information including metadata, attributes, devices, lists, segments, and message statistics.

Input Parameters

string
required
User ID of the Customer or Account (the ID you supplied when creating the user)

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: ENGAGE_LIST_LISTSTool to retrieve a paginated list of all Lists in Engage. Use when you need to view available Lists or iterate through all Lists in the account.

Input Parameters

integer
Number of Lists to return. Defaults to 10. Maximum of 30.
string
Pagination cursor for next dataset page
string
Pagination cursor for previous dataset page

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: ENGAGE_LIST_USERSTool to retrieve a paginated list of all users in Engage. Use when you need to list users with optional filtering by email and cursor-based pagination support.

Input Parameters

string
Filter results to return only users with this specific email address.
integer
Number of users to return. Defaults to 10. Maximum of 30.
string
Pagination cursor for retrieving the next page of results.
string
Pagination cursor for retrieving the previous page of results.

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: ENGAGE_MERGE_USERSTool to merge two user profiles in Engage. The source user is merged into the destination user, and the source user profile is removed. Use when you need to consolidate duplicate user accounts or combine user data from multiple profiles into a single account.

Input Parameters

string
required
The ID of the user to merge. This user will be merged into the destination user and the source user profile will be removed.
string
required
The ID of the user that the source user is being merged into. This user will contain all merged data.

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: ENGAGE_REMOVE_CUSTOMER_FROM_ACCOUNTTool to remove a Customer from an Account in Engage. Use when you need to disassociate a customer from a specific account.

Input Parameters

string
required
User ID of the Account to remove the Customer from. Example: ‘test_account_1739394000’
string
required
User ID of the Customer to remove from the Account. Example: ‘test_customer_1739394000’

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: ENGAGE_SEND_BATCH_REQUESTTool to batch multiple create user, update user, and add user events operations into a single API call. Use when you need to perform multiple operations efficiently at the cost of one API request. The batch is queued for processing without immediate validation, so ensure all parameters are correct. Request size must remain under 100KB.

Input Parameters

array
required
Array of batch operations. Each item must have ‘type’ and ‘id’, plus operation-specific parameters. Total request size must be under 100KB.

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: ENGAGE_SUBSCRIBE_USER_TO_LISTTool to create a user and subscribe them to an Engage.so List. Use when you need to add users to a specific list for email marketing or user segmentation. If the user already exists, they will be added to the List without creating a duplicate.

Input Parameters

string
required
The List ID to subscribe the user to.
object
Additional user attributes as key-value pairs. Values must be string, number, or boolean.
string
required
The user’s email address (required). Requires full authentication.
string
The user’s phone number in international format (e.g., +1234567890).
string
The user’s last name.
string
Creation date if the user already exists (ISO 8601 format recommended).
string
The user’s first name.

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: ENGAGE_TRACK_USER_EVENTTool to add user events to Engage. Use this to track user actions and events in your application. You can later segment users based on these actions or events.

Input Parameters

string
required
User ID of the Customer or Account
string
required
The event title
string
The event value. Can be string, number, or boolean
string
Timestamp of the event. Defaults to current time.
object
Object containing additional event properties (string, number, or boolean values)

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: ENGAGE_UPDATE_ACCOUNT_ROLETool to update the role of a Customer in an Account or set a new one if none exists. Use when you need to assign or change a customer’s role within a specific account.

Input Parameters

string
required
User ID of the Account in which to update the Customer’s role.
string
required
User ID of the Customer whose role to update.
string
required
The new role to assign to the Customer in the 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: ENGAGE_UPDATE_SUBSCRIBER_STATUSTool to update a subscriber’s status on a List. Use when you need to subscribe, re-subscribe, or unsubscribe a user from a specific List.

Input Parameters

string
required
The List ID to update the subscriber status for
string
required
The subscriber’s user ID
boolean
required
Set to true to subscribe or re-subscribe the user, false to unsubscribe

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: ENGAGE_UPDATE_USERTool to update user data and attributes on Engage. Use this to update user data changes like changes in plan, name, location, etc. If the user doesn’t exist, this method creates the user.

Input Parameters

string
required
User ID of the Customer or Account to update. This is the unique identifier for the user in your system.
object
Object containing additional user attributes to add or update. Use this for custom properties like plan, location, preferences, etc.
string
User’s email address. Updating email requires full authentication.
string
User’s phone number in international format (e.g., +1234567890).
string
User’s last name.
string
Date the user signed up. Should be a valid date string in ISO format.
string
User’s first name.
boolean
If true, converts user to account. If false and entity is account, converts to user.
string
User’s device token for push notifications.
string
Device platform: android or ios.

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