NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Userflow

userflow

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

Marketing AutomationProductivityWeb del proveedor
Acciones
18
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (18)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create or Update a GroupUSERFLOW_CREATE_OR_UPDATE_A_GROUPAcción

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.

Parámetros de entrada

  • idstringObligatorio

    Unique identifier for the group. Use an existing ID to update, or a new ID to create. Can be a UUID or custom ID.

  • attributesobject

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

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create or Update a UserUSERFLOW_CREATE_OR_UPDATE_A_USERAcción

Tool to create a new user or update an existing user in Userflow. Use when you need to synchronize user data from your back-end to Userflow. If the user ID exists, attributes will be merged; otherwise a new user is created.

Parámetros de entrada

  • idstringObligatorio

    Unique identifier for the user. Use an existing ID to update, or a new ID to create. Can be a UUID or custom ID.

  • groupsobject[]

    Array of group objects to assign the user to. Cannot be used together with memberships parameter (mutually exclusive). Used to organize users into groups.

  • signaturestring

    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.

  • attributesobject

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

  • membershipsobject[]

    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_membershipsboolean

    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.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete a Content SessionUSERFLOW_DELETE_A_CONTENT_SESSIONAcción

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.

Parámetros de entrada

  • content_session_idstringObligatorio

    The unique identifier of the content session to delete (UUID format).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete a GroupUSERFLOW_DELETE_A_GROUPAcción

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.

Parámetros de entrada

  • group_idstringObligatorio

    The unique identifier of the group to delete (UUID format).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete a UserUSERFLOW_DELETE_A_USERAcción

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.

Parámetros de entrada

  • user_idstringObligatorio

    The unique identifier of the user to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get a Content ObjectUSERFLOW_GET_A_CONTENT_OBJECTAcción

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.

Parámetros de entrada

  • expandstring

    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_idstringObligatorio

    The unique identifier (UUID) of the content object to retrieve. Example: '54bce034-1303-4200-a09a-780a2eee355d'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get a Content VersionUSERFLOW_GET_A_CONTENT_VERSIONAcción

Tool to retrieve details of a specific content version by ID. Use when you need to get information about a versioned content object, including its questions (for surveys) or tasks (for checklists).

Parámetros de entrada

  • version_idstringObligatorio

    The unique identifier (UUID) of the content version to retrieve. Example: '152a63cc-0a49-475a-a8e4-5f89bee94fe6'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get a GroupUSERFLOW_GET_A_GROUPAcción

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.

Parámetros de entrada

  • expandstring

    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_idstringObligatorio

    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'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get a UserUSERFLOW_GET_A_USERAcción

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.

Parámetros de entrada

  • expandstring

    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_idstringObligatorio

    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'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Attribute DefinitionsUSERFLOW_LIST_ATTRIBUTE_DEFINITIONSAcción

Tool to retrieve all attribute definitions for users and groups tracked by Userflow. Use when you need to see what attributes are being tracked. Attribute definitions are automatically created when new attributes are sent.

Parámetros de entrada

  • limitinteger

    Maximum number of attribute definitions to return per request. Used for pagination.

  • starting_afterstring

    Cursor for pagination. Takes an attribute definition ID to define the starting position for retrieving subsequent pages.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List ContentUSERFLOW_LIST_CONTENTAcción

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.

Parámetros de entrada

  • limitinteger

    Maximum number of content items to return per request. Used for pagination.

  • sort_bystring

    Field(s) to order results by. Specific fields vary by resource type.

  • starting_afterstring

    Cursor for pagination. Takes a content ID to define the starting position for retrieving subsequent pages.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Content SessionsUSERFLOW_LIST_CONTENT_SESSIONSAcción

Tool to retrieve all content sessions tracking user interactions with content. Use when you need to see user journeys through flows, checklists, or launchers, including their progress and survey answers.

Parámetros de entrada

  • limitinteger

    Maximum number of content sessions to return per request. Used for cursor-based pagination.

  • content_idstring

    Filter content sessions by a specific content ID. When provided, only returns sessions for that content object.

  • starting_afterstring

    Cursor for pagination. Takes a content session ID to define the starting position for retrieving subsequent pages.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Content VersionsUSERFLOW_LIST_CONTENT_VERSIONSAcción

Tool to retrieve all versions of content including survey questions and checklist tasks. Use when you need to see the version history of flows, checklists, or launchers to track changes over time.

Parámetros de entrada

  • limitinteger

    Maximum number of content versions to return per request. Used for cursor-based pagination.

  • content_idstringObligatorio

    Required content ID to filter content versions. Only returns versions for the specified content object.

  • starting_afterstring

    Cursor for pagination. Takes a content version ID to define the starting position for retrieving subsequent pages.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Event DefinitionsUSERFLOW_LIST_EVENT_DEFINITIONSAcción

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.

Parámetros de entrada

  • limitinteger

    Maximum number of event definitions to return per request. Used for pagination.

  • expandstring

    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_afterstring

    Cursor for pagination. Takes an event definition ID to define the starting position for retrieving subsequent pages.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List GroupsUSERFLOW_LIST_GROUPSAcción

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.

Parámetros de entrada

  • limitinteger

    Maximum number of groups to return per request. Used for pagination.

  • expandstring

    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_bystring

    Field name(s) to order results by. Each resource lists which fields can be ordered.

  • conditionstring

    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_afterstring

    Cursor for pagination. Takes a group ID to define the starting position for retrieving subsequent pages.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List UsersUSERFLOW_LIST_USERSAcción

Tool to retrieve a paginated list of all users. Use when you need to list users with optional filtering, sorting, and expansion of related objects like memberships and groups.

Parámetros de entrada

  • limitinteger

    Maximum number of users to return per request. Used for pagination.

  • expandstring

    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_bystring

    Orders results by one or more fields. Specific fields supported vary by resource.

  • conditionstring

    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_afterstring

    Cursor for pagination. Takes a user ID to define the starting position for retrieving subsequent pages.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Remove a User from a GroupUSERFLOW_REMOVE_A_USER_FROM_A_GROUPAcción

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.

Parámetros de entrada

  • user_idstringObligatorio

    The ID of the user to remove from the group.

  • group_idstringObligatorio

    The ID of the group to remove the user from.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Track an EventUSERFLOW_TRACK_AN_EVENTAcción

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.

Parámetros de entrada

  • namestringObligatorio

    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').

  • timestring

    The timestamp when the event occurred in ISO 8601 format. If not provided, the current time will be used.

  • user_idstring

    The ID of the user the event is associated with. Either user_id or group_id (or both) should be provided.

  • group_idstring

    The ID of the group/company the event is associated with. Either user_id or group_id (or both) should be provided.

  • attributesobject

    A dictionary of custom attributes about the event. Can contain any key-value pairs relevant to the event.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not