---
title: "Assign Key-Value to Client from MindBehind Live and APIs"
slug: "assign-key-value-to-client-from-mindbehind-live-and-apis"
description: "Assign key-value data to clients from MindBehind Live and APIs to store custom attributes, track user context and power more personalized conversations."
tags: ["key-value"]
updated: 2026-03-15T08:24:54Z
published: 2026-03-15T08:24:54Z
canonical: "academy.insiderone.com/assign-key-value-to-client-from-mindbehind-live-and-apis"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Assign Key-Value to Client from MindBehind Live and APIs

This guide aims to explain how to assign key values to clients from MindBehind Live and APIs.

To assign a key value to clients from MindBehind Live and APIs, follow the steps below:

1. Go to [MindBehind Live](https://live.mindbehind.com/login).
2. If the agent has an open live conversation with the correct client panel, they can select the **Profile** tab to add or remove a key-value property of the client. ![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/key*.png)

To use the APIs, you need the information below:

Get Client:

- **Endpoint URL**: https://app.mindbehind.com/live-core/getClient
- **HTTP Method**: GET
- **Query Parameters**: Should contain:
- **clientID**: This is your system client ID. It can be any string. You can also use your client's phone number if you want.
- **companyID**: This is your company ID. You can find that information on the Company Profile page.
- **Result**: You will get a JSON payload as follows:

> {
> 
> name: string!;
> 
> surname: string!;
> 
> email: string!;
> 
> phone: string!;
> 
> companyID: string!;
> 
> clientID: string!;
> 
> channelType: string!;
> 
> tags: string[];
> 
> 
> 
> keyValueProperties: {key:string,value:string}[];
> 
> }

To set Key-Value Property:

- **Endpoint URL**: https://app.mindbehind.com/live-core/setKeyValueProperties
- **HTTP Method**: POST
- **Body**: Should contain:
  - **clientID**: This is your system client ID. It can be any string. You can also use your client's phone number if you want
  - **KeyValueProperties:** array of objects containing key as string and value as string **([{key:string,value:string}])**
- **Result**: You will get a JSON payload as follows:

> {
> 
> name: string!;
> 
> surname: string!;
> 
> email: string!;
> 
> phone: string!;
> 
> companyID: string!;
> 
> clientID: string!;
> 
> channelType: string!;
> 
> tags: string[];
> 
> keyValueProperties: {key:string,value:string}[];
> 
> }