Skip to main content
The Code node lets you run custom JavaScript within your flow. It is useful for operations that cannot be achieved with standard nodes: transforming data, performing calculations, manipulating text, or integrating custom business logic.

​
Accessing variables

Inside the Code node you can read and write flow variables using predefined global objects.

​
Context ($context)

Variables that persist only during the current flow execution: 
// Read
const name = $context.get('name')
const name = $context.get('name', 'John') // with default value

// Write
$context.set('lastOrder.status', 'delivered')
$context.set('user', { name: 'John', plan: 'gold' })

​
Memory ($memory)

Variables that persist across workflows, tools, and nodes. They support time-to-live (TTL): 
// Primitives (string, number, boolean) - optional TTL
$memory.set('name', 'John')
$memory.set('attempts', 3, 3600) // expires in 1 hour

// JSON - TTL required (in seconds, maximum 86,400 = 1 day)
$memory.setJson('user', { name: 'John', plan: 'gold' }, 86400)

// Files - async, TTL required (maximum 604,800 = 1 week)
await $memory.setFile('receipt', base64String, 604800, 'application/pdf')

​
Reading

const name = $memory.get('name')
const user = $memory.getJson('user')
const url = $memory.getFile('receipt').toUrl()           // temporary URL
const base64 = await $memory.getFile('receipt').toBase64()

​
Deletion

$memory.delete('temporary')
$memory.delete(['tmp1', 'tmp2', 'cache']) // multiple keys

​
Limits by data type

TypeMaximum sizeTTLMaximum TTL
String255 charactersOptional—
Number15 digitsOptional—
Boolean—Optional—
JSON15 KBRequired86,400s (1 day)
File10 MBRequired604,800s (1 week)
The methods $memory.setFile(), $memory.getFile().toBase64(), and $memory.getFile().toRaw() are asynchronous. You must use await when calling them.

​
Migration from legacy nodes

  1. Create a new Code (Memory V2) node.
  2. Copy and paste the script from the legacy node.
  3. Use the new available methods ($memory.setJson, $memory.setFile, etc.) if needed.

​
User ($user)

Information about the contact interacting with your flow: 
const userId = $user.get('id')
const userName = $user.get('names')

​
Message ($message)

The last message sent by the user: 
const text = $message.get('text')
const type = $message.get('type')       // TEXT, IMAGE, AUDIO, VIDEO, LOCATION, FILE
const attachmentUrl = $message.get('mediaUrl')
const lat = $message.get('lat')
const lng = $message.get('lng')

​
Input/Output (input,input, output)

For communication between tools and workflows: 
const city = $input.get('city', 'Quito')  // with default value
$output.set('data', result)

​
HTTP responses

If you saved the response from an API node: 
let apiResponse = $context.getHttpResponse('apiResponse')
apiResponse = apiResponse.json()

$memory.set('name', apiResponse.data.user.name)
The key in $context.getHttpResponse() must match exactly the one you configured in the “Save response” field of the API node.

​
Available utilities

​
Logger

Logs values for debugging in key-value format. Logs appear in the execution history: 
// Primitives are stored as-is
$utils.logger.log('userId', 1245)
$utils.logger.log('status', 'active')

// Objects and arrays are converted to string (truncated to 512 characters)
$utils.logger.log('orderData', { id: 1, name: 'christian' })
Each node allows a maximum of 10 log entries. The value of each entry has a limit of 512 characters.

​
Crypto

Standard cryptographic functions: 
$utils.crypto.createHash('sha256')
$utils.crypto.createHmac('sha256', key)
$utils.crypto.randomBytes(32)

​
Lodash

Utilities for manipulating arrays, objects, and strings: 
$utils._.get(object, 'nested.path', defaultValue)
$utils._.uniq(array)
$utils._.chunk(array, size)
$utils._.merge(object1, object2)
Allowed MIME types for $memory.setFile():
CategoryTypes
Texttext/plain
JSON/XMLapplication/json, application/xml, text/xml
Imagesimage/jpeg, image/png, image/gif
Videosvideo/mp4, video/ogg, video/webm, video/x-msvideo, video/mpeg
Audioaudio/mpeg, audio/wav, audio/ogg, audio/aac, audio/flac
Documentsapplication/pdf