Reference
JSON serialise & deserialise node
Please contact your Customer Success Manager to get access to this node. This is a dedicated feature that is not generally available.
What is JSON serialise & deserialise?
JSON serialisation is like zipping files – you take complex data (like lists or objects) and compress it into a simple format (JSON) for easier storage or transfer. Deserialisation is like unzipping, it takes that compressed JSON and converts it back into usable data for systems to work with. Both processes make data easier to manage, store, and transfer between systems.
These two nodes enable conversions to and from the JSON format so that it can be efficiently stored, transferred, or used in different systems. JSON (JavaScript Object Notation) is a widely used format because it’s both human-readable and easy for computers to process. They enable seamless communication between services, efficient data storage, and flexible interaction with APIs which enables data integrity and compatibility across different platforms and technologies.
JSON serialise
JSON serialisation converts structured data like numbers, text, lists, or objects into a JSON-formatted string. This is useful when you need to store or send data in a way that other systems or applications can understand.
| Example input | Example output |
| leadId: L2045 name: Jane Smith company: TechGrowth Inc score: 85 interests: cloud solutions, cybersecurity recentActivity: downloaded whitepaper |
{ |
JSON deserialise
JSON deserialisation converts a JSON-formatted string back into usable data (such as a list, number, or object). This is necessary when working with data after it has been received or retrieved. When deserialising JSON using the schema, please note that the contents of the serialised string are strictly checked.
Usage scenarios
A sales team integrates an AI agent into a flow to analyse potential leads. The agent returns insights as serialised JSON strings. For example, {"leadId":"L2045","name":"Jane Smith","company":"TechGrowth Inc","score":85,"interests":["cloud solutions","cybersecurity"],"recentActivity":"downloaded whitepaper"}
Using the JSON deserialise action, the team converts this structured data into accessible merge fields. This allows individual details such as the name, company, and interest areas to be directly used in the flow. In this use case, the flow uses these extracted values to update the CRM record — leads with high scores (like Jane’s 85/100) can be automatically flagged for immediate sales engagement, streamlining the team's workflow.
Configuration of the actions
JSON serialise
Input data to serialise: Serialises selected data (such as an object, array, etc.) into a JSON-reversible string.
JSON deserialise
Input data to deserialise: Input a merge field containing serialised JSON.
Code input field: Input an example of the JSON schema to check against. When deserialising JSON using the schema above, please note that the contents of the serialised string are strictly checked. If a property is missing, or a type does not match, this action will fail.
Related to