• USER
  • ACCOUNT
  • BULK
  • HUMAN

How to update user profiles with your AI

Connect Heap to your AI client to manage data properties. You can enrich single profiles or update entire groups of users with simple text commands.

Ask AI about this page

Short answer

How can I update user profiles using my AI?

You give your AI instructions to add specific properties to users or accounts. It then uses Heap tools to apply those changes to individual profiles or large batches of users at once.

Data destinations

Where your updates land.

The AI maps your requests to specific Heap data structures.

USER

Single profile updates

The AI adds specific traits to one user at a time. This is useful for immediate enrichment after a specific user action.

ACCOUNT

Account-level data

You can update properties for an entire account. This helps you manage B2B data like company size or industry.

BULK

Mass enrichments

The AI handles large-scale updates for many users at once. This keeps your entire user base in sync with external data.

HUMAN

Manual oversight

You remain in control of which properties are modified. You decide when to let the AI run a bulk update versus a single change.

The workflow

What your AI does when the request arrives.

Your AI interprets your natural language and executes the corresponding Heap command.

  1. Analyze intent

    Your AI determines if you want to change a single user, an account, or a large group of people.

    add_user_properties

  2. Enrich user profiles

    The AI applies new key-value pairs to a specific user's profile in Heap.

    add_user_properties

  3. Update account data

    The AI modifies properties at the account level to keep organizational data accurate.

    add_account_properties

  4. Perform bulk updates

    The AI processes mass property changes for multiple users in one go.

    bulk_add_user_properties

Try it

Copy these to start.

Use these prompts to begin updating your Heap data.

Starting points

Replace the user IDs and property names with your actual Heap data.

Heap Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Heap capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "heap-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Pn4btlTsBht307lZ93t32Og42XTCaaYQZ5x3ubYE/mcp"
    }
  }
}
Copy into chat04

  • Add the property 'membership_level' as 'gold' for user ID 550e8400.

  • Update the 'company_size' property to '500+' for account ID acc_9921.

  • Bulk update the 'is_active_subscriber' property to 'true' for all users in my recent CSV list.

  • Set the 'last_purchase_category' to 'electronics' for user user_772.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Heap once, then ask.

Link your Heap account to Vinkius to get started. Your login details stay encrypted, and you can immediately start talking to your data.

Connect Heap to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete properties from Heap?

    No. The AI can only add or update properties; it cannot delete existing ones.

  • 02

    Can I use this to create brand new users?

    No. This Connector is for updating properties on users and accounts that already exist in Heap.

  • 03

    Does the AI need to ask for permission for every update?

    No. Once connected, the AI executes the tools directly based on your instructions.

  • 04

    Can I update account properties for a single user?

    No. You must specify if you are updating a user profile or an account profile.

  • 05

    Can the AI perform bulk updates without a list?

    No. You need to provide the context or the list of users you want to target for a bulk update.

  • More questions about Heap? See everything the Heap Connector can do

Connect Heap to Claude, Cursor, ChatGPT & more