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

# Userflow

> User onboarding software. Build product tours, checklists and more. No coding needed.

![Userflow logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/userflow.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=96f50e2886730c9b807f4fa9d621d4af)

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

## Tools

> [accordion] Create or Update a Group
>
> **Slug:** `USERFLOW_CREATE_OR_UPDATE_A_GROUP`
>
> Tool 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
>
> **id** `string` *required*
>
> Unique identifier for the group. Use an existing ID to update, or a new ID to create. Can be a UUID or custom ID.
>
> **attributes** `object`
>
> 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
>
> **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] Create or Update a User
>
> **Slug:** `USERFLOW_CREATE_OR_UPDATE_A_USER`
>
> Create 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
>
> **id** `string` *required*
>
> Unique identifier for the user. Use an existing ID to update, or a new ID to create. Can be a UUID or custom ID.
>
> **groups** `array`
>
> Array of group objects to assign the user to. Cannot be used together with memberships parameter (mutually exclusive). Used to organize users into groups.
>
> **signature** `string`
>
> 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.
>
> **attributes** `object`
>
> 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).
>
> **memberships** `array`
>
> 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.
>
> **prune\_memberships** `boolean`
>
> 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
>
> **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] Delete a Content Session
>
> **Slug:** `USERFLOW_DELETE_A_CONTENT_SESSION`
>
> Tool 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
>
> **content\_session\_id** `string` *required*
>
> The unique identifier of the content session to delete (UUID format).
>
> #### 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] Delete a Group
>
> **Slug:** `USERFLOW_DELETE_A_GROUP`
>
> Tool 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
>
> **group\_id** `string` *required*
>
> The unique identifier of the group to delete (UUID format).
>
> #### 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] Delete a User
>
> **Slug:** `USERFLOW_DELETE_A_USER`
>
> Tool 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
>
> **user\_id** `string` *required*
>
> The unique identifier of the user to delete.
>
> #### 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 a Content Object
>
> **Slug:** `USERFLOW_GET_A_CONTENT_OBJECT`
>
> Tool 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
>
> **expand** `string`
>
> 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.
>
> **content\_id** `string` *required*
>
> The unique identifier (UUID) of the content object to retrieve. Example: '54bce034-1303-4200-a09a-780a2eee355d'
>
> #### 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 a Content Version
>
> **Slug:** `USERFLOW_GET_A_CONTENT_VERSION`
>
> Retrieve a specific content version by ID, including its version metadata. Questions and checklist tasks are not expanded by this tool.
>
> #### Input Parameters
>
> **version\_id** `string` *required*
>
> The unique identifier (UUID) of the content version to retrieve. Example: '152a63cc-0a49-475a-a8e4-5f89bee94fe6'
>
> #### 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 a Group
>
> **Slug:** `USERFLOW_GET_A_GROUP`
>
> Tool 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
>
> **expand** `string`
>
> 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'
>
> **group\_id** `string` *required*
>
> 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
>
> **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 a User
>
> **Slug:** `USERFLOW_GET_A_USER`
>
> Tool 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
>
> **expand** `string`
>
> 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'
>
> **user\_id** `string` *required*
>
> 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
>
> **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 Attribute Definitions
>
> **Slug:** `USERFLOW_LIST_ATTRIBUTE_DEFINITIONS`
>
> List Userflow attribute definitions for users, groups, group memberships, and events. Definitions are automatically created when new attributes are sent.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of attribute definitions to return per request. Used for pagination.
>
> **starting\_after** `string`
>
> Cursor for pagination. Takes an attribute definition ID to define the starting position for retrieving subsequent pages.
>
> #### 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 Content
>
> **Slug:** `USERFLOW_LIST_CONTENT`
>
> Tool 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
>
> **limit** `integer`
>
> Maximum number of content items to return per request. Used for pagination.
>
> **sort\_by** `string`
>
> Field(s) to order results by. Specific fields vary by resource type.
>
> **starting\_after** `string`
>
> Cursor for pagination. Takes a content ID to define the starting position for retrieving subsequent pages.
>
> #### 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 Content Sessions
>
> **Slug:** `USERFLOW_LIST_CONTENT_SESSIONS`
>
> List content sessions tracking user journeys through flows, checklists, or launchers, including their progress. Results can be filtered by content ID and paginated.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of content sessions to return per request. Used for cursor-based pagination.
>
> **content\_id** `string`
>
> Filter content sessions by a specific content ID. When provided, only returns sessions for that content object.
>
> **starting\_after** `string`
>
> Cursor for pagination. Takes a content session ID to define the starting position for retrieving subsequent pages.
>
> #### 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 Content Versions
>
> **Slug:** `USERFLOW_LIST_CONTENT_VERSIONS`
>
> List 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
>
> **limit** `integer`
>
> Maximum number of content versions to return per request. Used for cursor-based pagination.
>
> **content\_id** `string` *required*
>
> Required content ID to filter content versions. Only returns versions for the specified content object.
>
> **starting\_after** `string`
>
> Cursor for pagination. Takes a content version ID to define the starting position for retrieving subsequent pages.
>
> #### 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 Event Definitions
>
> **Slug:** `USERFLOW_LIST_EVENT_DEFINITIONS`
>
> Tool 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
>
> **limit** `integer`
>
> Maximum number of event definitions to return per request. Used for pagination.
>
> **expand** `string`
>
> Comma-separated list of fields to expand in the response. Can expand up to 4 levels deep using dot notation (e.g., 'field.subfield').
>
> **starting\_after** `string`
>
> Cursor for pagination. Takes an event definition ID to define the starting position for retrieving subsequent pages.
>
> #### 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 Groups
>
> **Slug:** `USERFLOW_LIST_GROUPS`
>
> Tool 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
>
> **limit** `integer`
>
> Maximum number of groups to return per request. Used for pagination.
>
> **expand** `string`
>
> 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.
>
> **sort\_by** `string`
>
> Field name(s) to order results by. Each resource lists which fields can be ordered.
>
> **condition** `string`
>
> 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.
>
> **starting\_after** `string`
>
> Cursor for pagination. Takes a group ID to define the starting position for retrieving subsequent pages.
>
> #### 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 Users
>
> **Slug:** `USERFLOW_LIST_USERS`
>
> Retrieve a paginated list of users with optional attribute filtering and requests to expand related objects such as memberships and groups.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of users to return per request. Used for pagination.
>
> **expand** `string`
>
> 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.
>
> **sort\_by** `string`
>
> Orders results by one or more fields. Specific fields supported vary by resource.
>
> **condition** `string`
>
> 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"}'
>
> **starting\_after** `string`
>
> Cursor for pagination. Takes a user ID to define the starting position for retrieving subsequent pages.
>
> #### 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] Remove a User from a Group
>
> **Slug:** `USERFLOW_REMOVE_A_USER_FROM_A_GROUP`
>
> Tool to remove a user from a group (group membership). Use when you need to revoke a user's membership in a specific group. This operation is idempotent and will succeed even if the user is not already a member of the group.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> The ID of the user to remove from the group.
>
> **group\_id** `string` *required*
>
> The ID of the group to remove the user 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

> [accordion] Track an Event
>
> **Slug:** `USERFLOW_TRACK_AN_EVENT`
>
> Tool 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
>
> **name** `string` *required*
>
> 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').
>
> **time** `string`
>
> The timestamp when the event occurred in ISO 8601 format. If not provided, the current time will be used.
>
> **user\_id** `string`
>
> The ID of the user the event is associated with. Either user\_id or group\_id (or both) should be provided.
>
> **group\_id** `string`
>
> The ID of the group/company the event is associated with. Either user\_id or group\_id (or both) should be provided.
>
> **attributes** `object`
>
> A dictionary of custom attributes about the event. Can contain any key-value pairs relevant to the event.
>
> #### 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
