# Engage

Engage turns your customers into fans with personalised messaging; using emails, push and in-app notifications, and SMS.

- **Category:** marketing automation
- **Auth:** BASIC
- **Tools:** 22
- **Triggers:** 0
- **Slug:** `ENGAGE`
- **Version:** 00000000_00

## Tools

### Add Customer to Accounts

**Slug:** `ENGAGE_ADD_CUSTOMER_TO_ACCOUNTS`

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

### Add User to Lists

**Slug:** `ENGAGE_ADD_USER_TO_LISTS`

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

### Archive List

**Slug:** `ENGAGE_ARCHIVE_LIST`

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

### Archive User

**Slug:** `ENGAGE_ARCHIVE_USER`

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

### Convert User Type

**Slug:** `ENGAGE_CONVERT_USER_TYPE`

Tool to convert a user between Customer and Account entity types. Use when you need to change a customer to an account or vice versa.

### Create List

**Slug:** `ENGAGE_CREATE_LIST`

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

### Create User

**Slug:** `ENGAGE_CREATE_USER`

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

### Delete Subscriber From List

**Slug:** `ENGAGE_DELETE_SUBSCRIBER_FROM_LIST`

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

### Delete User

**Slug:** `ENGAGE_DELETE_USER`

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

### Get Account Members

**Slug:** `ENGAGE_GET_ACCOUNT_MEMBERS`

Tool to retrieve all members (Customers) of an Account in Engage. Use when you need to list users who are part of a specific account.

### Get List

**Slug:** `ENGAGE_GET_LIST`

Tool to retrieve a single List by its ID. Use when you need to fetch details about a specific List.

### Get User By ID

**Slug:** `ENGAGE_GET_USER`

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

### List Lists

**Slug:** `ENGAGE_LIST_LISTS`

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

### List Users

**Slug:** `ENGAGE_LIST_USERS`

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

### Merge Users

**Slug:** `ENGAGE_MERGE_USERS`

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

### Remove Customer from Account

**Slug:** `ENGAGE_REMOVE_CUSTOMER_FROM_ACCOUNT`

Tool to remove a Customer from an Account in Engage. Use when you need to disassociate a customer from a specific account.

### Batch Request

**Slug:** `ENGAGE_SEND_BATCH_REQUEST`

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

### Subscribe User to List

**Slug:** `ENGAGE_SUBSCRIBE_USER_TO_LIST`

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

### Track User Event

**Slug:** `ENGAGE_TRACK_USER_EVENT`

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

### Update Account Role

**Slug:** `ENGAGE_UPDATE_ACCOUNT_ROLE`

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

### Update Subscriber Status

**Slug:** `ENGAGE_UPDATE_SUBSCRIBER_STATUS`

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

### Update User

**Slug:** `ENGAGE_UPDATE_USER`

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