- Category: marketing automation
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 18
- Triggers: 0
- Slug:
USERFLOW - Version: 20261101_00
Tools
Create or Update a Group
Create or Update a Group
Slug:
USERFLOW_CREATE_OR_UPDATE_A_GROUPTool to create a new group or update an existing group (also referred to as companies in the Userflow UI). Use when you need to create a new group or update attributes of an existing group by providing the group ID.Input Parameters
Unique identifier for the group. Use an existing ID to update, or a new ID to create. Can be a UUID or custom ID.
Free-form dictionary of custom attributes for the group. Common fields include name, billing_plan, and signed_up_at. Attribute names can only contain a-z, A-Z, 0-9, underscores, dashes, and spaces (snake_case recommended).
Output
Create or Update a User
Create or Update a User
Slug:
USERFLOW_CREATE_OR_UPDATE_A_USERCreate or update a Userflow user by ID, merging supplied attributes for an existing user. The request can also assign groups and, when membership pruning is enabled, remove existing memberships omitted from the supplied list.Input Parameters
Unique identifier for the user. Use an existing ID to update, or a new ID to create. Can be a UUID or custom ID.
Array of group objects to assign the user to. Cannot be used together with memberships parameter (mutually exclusive). Used to organize users into groups.
Used for identity verification to add additional security. SHA-256 HMAC of the user’s ID signed with your Userflow environment’s Secret Key. Only required when identity verification is enabled.
Free-form dictionary of custom attributes for the user. Common fields include name, email, email_verified, signed_up_at, and project_count. Attribute names can only contain a-z, A-Z, 0-9, underscores, dashes, and spaces (snake_case recommended).
Array of membership objects defining user’s group associations. Cannot be used together with groups parameter (mutually exclusive). At most only one of either groups or memberships can be set per request.
When true, removes existing memberships not included in the request. Default is false. Only set to true if the groups or memberships list contains ALL groups the user belongs to.
Output
Delete a Content Session
Delete a Content Session
Slug:
USERFLOW_DELETE_A_CONTENT_SESSIONTool to permanently delete a content session including its associated progress and survey answers. Use when you need to remove a content session from the system. This action cannot be undone. This operation is idempotent and will succeed even if the content session already doesn’t exist.Input Parameters
Output
Delete a Group
Delete a Group
Slug:
USERFLOW_DELETE_A_GROUPTool to permanently delete a group including all their attributes, memberships and events. Use when you need to remove a group from the system. This action cannot be undone, but users who were members of the group will remain intact. This operation is idempotent and will succeed even if the group already doesn’t exist.Input Parameters
Output
Delete a User
Delete a User
Slug:
USERFLOW_DELETE_A_USERTool to permanently delete a user including all their attributes, memberships, events and flow history. Use when you need to remove a user from the system. This action cannot be undone, but groups that the user was a member of will remain intact. This operation is idempotent and will succeed even if the user already doesn’t exist.Input Parameters
Output
Get a Content Object
Get a Content Object
Slug:
USERFLOW_GET_A_CONTENT_OBJECTTool to retrieve details of a specific content object (flow, checklist, or launcher) by ID. Use when you need to get information about a single content object, including its draft and published versions.Input Parameters
Specifies related objects or lists to be expanded in the response (e.g., ‘draft_version’ or ‘published_version’). You can expand to a maximum of 4 levels deep using dot notation.
The unique identifier (UUID) of the content object to retrieve. Example: ‘54bce034-1303-4200-a09a-780a2eee355d’
Output
Get a Content Version
Get a Content Version
Slug:
USERFLOW_GET_A_CONTENT_VERSIONRetrieve a specific content version by ID, including its version metadata. Questions and checklist tasks are not expanded by this tool.Input Parameters
The unique identifier (UUID) of the content version to retrieve. Example: ‘152a63cc-0a49-475a-a8e4-5f89bee94fe6’
Output
Get a Group
Get a Group
Slug:
USERFLOW_GET_A_GROUPTool to retrieve details of a specific group (company) by group_id. Use when you need to get information about a group including their attributes, creation timestamp, and optionally expanded relationships like memberships and users. Note: Groups are called ‘Companies’ in the Userflow UI, but the API uses ‘groups’ terminology.Input Parameters
Comma-separated list of relationships to expand. By default, relationships like memberships and users will be null. Use dot notation for nested expansion (e.g., ‘memberships.user’). Can expand up to 4 levels deep. Example values: ‘memberships’, ‘users’, ‘memberships.user’
The unique identifier of the group to retrieve. Can be a UUID or custom ID. Example: ‘test-group-123’ or ‘ab82c312-b3a4-4feb-870c-53dd336f955e’
Output
Get a User
Get a User
Slug:
USERFLOW_GET_A_USERTool to retrieve details of a specific user by user_id. Use when you need to get information about a user including their attributes, creation timestamp, and optionally expanded relationships like memberships and groups.Input Parameters
Comma-separated list of relationships to expand. By default, relationships like memberships and groups will be null. Use dot notation for nested expansion (e.g., ‘memberships.group’). Can expand up to 4 levels deep. Example values: ‘memberships’, ‘groups’, ‘memberships.group’
The unique identifier of the user to retrieve. Can be a UUID or custom ID. Example: ‘test-user-123’ or ‘34907ae0-24e0-4261-ac31-3c7299a354c0’
Output
List Attribute Definitions
List Attribute Definitions
Slug:
USERFLOW_LIST_ATTRIBUTE_DEFINITIONSList Userflow attribute definitions for users, groups, group memberships, and events. Definitions are automatically created when new attributes are sent.Input Parameters
Cursor for pagination. Takes an attribute definition ID to define the starting position for retrieving subsequent pages.
Output
List Content
List Content
Slug:
USERFLOW_LIST_CONTENTTool to retrieve all content (flows, checklists, and launchers) in your Userflow account. Use when you need to check what content is available for users to start in your application.Input Parameters
Cursor for pagination. Takes a content ID to define the starting position for retrieving subsequent pages.
Output
List Content Sessions
List Content Sessions
Slug:
USERFLOW_LIST_CONTENT_SESSIONSList content sessions tracking user journeys through flows, checklists, or launchers, including their progress. Results can be filtered by content ID and paginated.Input Parameters
Filter content sessions by a specific content ID. When provided, only returns sessions for that content object.
Cursor for pagination. Takes a content session ID to define the starting position for retrieving subsequent pages.
Output
List Content Versions
List Content Versions
Slug:
USERFLOW_LIST_CONTENT_VERSIONSList versions of a specified content object to inspect its version history. Results are paginated; survey questions and checklist tasks are not expanded by this tool.Input Parameters
Required content ID to filter content versions. Only returns versions for the specified content object.
Cursor for pagination. Takes a content version ID to define the starting position for retrieving subsequent pages.
Output
List Event Definitions
List Event Definitions
Slug:
USERFLOW_LIST_EVENT_DEFINITIONSTool to retrieve all event definitions tracked in Userflow. Use when you need to see what events are being tracked. Event definitions are automatically created when new events are tracked.Input Parameters
Comma-separated list of fields to expand in the response. Can expand up to 4 levels deep using dot notation (e.g., ‘field.subfield’).
Cursor for pagination. Takes an event definition ID to define the starting position for retrieving subsequent pages.
Output
List Groups
List Groups
Slug:
USERFLOW_LIST_GROUPSTool to retrieve all groups (companies) in your Userflow account with pagination and filtering support. Use when you need to list groups or search for specific groups based on attributes. Note: Groups are called ‘Companies’ in the Userflow UI.Input Parameters
Comma-separated list of fields to expand in the response (e.g., ‘memberships’, ‘memberships.user’). Can expand up to 4 levels deep using dot notation.
JSON-formatted string to filter the list based on attributes. Supports operators like eq, ne, contains, empty, gt, lt, includes_all, starts_with. Condition filtering matches up to 10,000 records maximum. Supports AND/OR logic with nested conditions.
Cursor for pagination. Takes a group ID to define the starting position for retrieving subsequent pages.
Output
List Users
List Users
Slug:
USERFLOW_LIST_USERSRetrieve a paginated list of users with optional attribute filtering and requests to expand related objects such as memberships and groups.Input Parameters
Comma-separated list of relationships to expand. Can expand has-many relationships like memberships and groups. Supports recursive expansion with dot notation (e.g., ‘memberships.group’). Maximum depth: 4 levels.
JSON-formatted string to filter users based on attributes. Supports operators like eq, ne, gt, gte, lt, lte, contains, not_contains, between, empty, not_empty, includes_all, includes_any, excludes_all, excludes_any, starts_with, ends_with. Supports AND/OR logic. Attribute names can reference user attributes (default), group attributes (prefix with ‘group/’), or membership attributes (prefix with ‘group_membership/’). Example: ’{“type”: “attribute”, “attribute_name”: “group/plan”, “operator”: “eq”, “value”: “Pro”}’
Cursor for pagination. Takes a user ID to define the starting position for retrieving subsequent pages.
Output
Remove a User from a Group
Remove a User from a Group
Track an Event
Track an Event
Slug:
USERFLOW_TRACK_AN_EVENTTool to record a custom event for a user or group for analytics and personalization. Use when you need to track user actions or behaviors. Events can be associated with just a user, just a group, or both a user and a group.Input Parameters
The name of the event being tracked. Must consist only of a-z, A-Z, 0-9, underscores, dashes, periods(.) and spaces. Recommended format: snake_case with noun and past-tense verb (e.g., ‘subscription_activated’).
The timestamp when the event occurred in ISO 8601 format. If not provided, the current time will be used.
The ID of the user the event is associated with. Either user_id or group_id (or both) should be provided.
The ID of the group/company the event is associated with. Either user_id or group_id (or both) should be provided.
A dictionary of custom attributes about the event. Can contain any key-value pairs relevant to the event.