Help

Store data from code steps with StoreClient

tutorial
Last updated:

The StoreClient is a built-in utility available in both Python and JavaScript code steps that lets you store and retrieve data between Zaps or between runs of the same Zap.

Limitations

  • Any JSON serializable value can be saved.
  • The secret must be less than 32 characters in length.
  • Every key must be less than 32 characters in length.
  • Every value must be less than 2500 bytes.
  • Only 500 keys may be saved per secret.
  • Keys will expire if you do not touch them in 3 months.

1. Set a secret for the StoreClient

First, you'll need to provide a secret that will protect your data. Be very sure you pick a complex secret. If anyone guesses it, they'll be able to read and write your data. It's recommended to use Random.org's password generator to generate a secret.


2. Use the StoreClient with JavaScript steps

Instantiating a client is very simple:

var store = StoreClient('your secret here');

Note

StoreClient is a promise-based library and a great time to get familiar with async and await!


3. Get and set values with JavaScript

Most likely you just want to get and set some values - this is the simplest possible example:

const store = StoreClient('your secret here');
await store.set('hello', 'world');
const value = await store.get('hello');
return {result: value} // value === 'world'

If the value doesn't exist during your get() call, it will return a null value.


4. Bulk operations with JavaScript

You can also save and retrieve multiple keys and values - a slightly more complex example:

const store = StoreClient('your secret here');
await store.setMany({hello: 'world', foo: 'bar'})
const values = await store.getMany('hello', 'foo');
// values === {hello: 'world', foo: 'bar'}
await store.deleteMany('hello', 'foo');
// or, if you want to wipe everything
await store.clear();

Note, you can call getMany and deleteMany in a few different ways:

store.getMany('hello', 'foo'); // as arguments
store.getMany(['hello', 'foo']); // as array
store.getMany({hello: null, foo: null}); // as object

5. Use the StoreClient with Python steps

When working with StoreClient, as for all Python Code steps, you will need to return a dictionary or an array of dictionaries. Returning a string will result in an error.

store = StoreClient('your secret here')

6. Get and set values with Python

Most likely you just want to get and set some values. This is the simplest possible example:

store = StoreClient('your secret here')
store.set('hello', 'world')
value = store.get('hello') # return 'world'
store.delete('hello')

If the value doesn't exist during your get() call, it will return a None value.


7. Bulk operations with Python

You can also save and retrieve multiple keys and values - a slightly more complex example:

store = StoreClient('your secret here')
store.set_many({'hello': 'world', 'foo': 'bar'})
values = store.get_many('hello', 'foo') # return {'hello': 'world', 'foo': 'bar'}
store.delete_many('hello', 'foo')
store.clear() # or, if you want to wipe everything

Note, you can call get_many and delete_many in a few different ways:

store.get_many('hello', 'foo') # as args
store.get_many(['hello', 'foo']) # as list
store.get_many({'hello': None, 'foo': None}) # as dict

And similarly with set_many:

store.set_many({'hello': 'world', 'foo': 'bar'}) # as dict
store.set_many(hello='world', foo='bar') # as kwargs

8. Other Python operations

Slightly more complex examples include incrementing a numeric value, setting a value if a condition is met or pushing/popping from lists. These operations also have the benefit that they are atomic.

increment_by increments a value found under a given key. The value has to be a numeric value in order for this operation to succeed:

store.increment_by(key, amount)

set_value_if sets a value if a condition is met. If the value stored under the given key matches the same value as the given previous value, then the given value parameter will become the new value of the key.

store.set(key, 1) # set a value
# sets 2 only if the previous value of *key* is 1
store.set_value_if(key, value=2, previous_value=1)

set_child_values/remove_child_values can be useful for storing/removing nested values. The value under the given key has to be a dictionary.

```python
store.set_child_values(key, {'a': 'b'}) # store under the given key the key `a` with value `b`
store.remove_child_values(key, ['a', 'c']) # remove the keys `a` and 'c' from the mapping found at `key`

list_pop/list_push can be useful for manipulating lists.

store.list_push(key, some_value)
store.list_pop(key)

Additionally, list_push and list_pop accept a location parameter.

store.list_push(key, value, location='tail') # Push to the tail of the list
store.list_push(key, value, location='tail_set') # Push to the tail of the list only if the value is not already in the list
store.list_push(key, value, location='head') # Push to the head of the list
store.list_push(key, value, location='head_set') # Push to the head of the list only if the value is not already in the list
store.list_pop(key, location='tail') # Pop from the end of the list
store.list_pop(key, location='head') # Pop from the head of the list

list_pop can also receive a default parameter, which will be returned when there is nothing to pop from the given list:

store.list_pop(key, default=1, location='tail')

Was this doc helpful?

Need More Help?

Zapier Support

Contact our world class support team and we’ll be happy to help you get up and running!
Contact Us

Hire an Expert

We have a directory of professionals across the globe who are ready to help.
Find a Zapier Expert