Store customer-specific data

Step-by-step guide on how to store customer-specific data retrievable in your app, in Nango scripts, and on the Nango UI.

Nango lets you store arbitrary metadata on individual connections. This is useful for customizing an integration’s behavior per end-customer.

Connection metadata can be set, updated & retrieved with the SDK (reference) & API (reference). It can also be retrieved on the Nango UI, in the Connections tab> Select Connection > Authorization tab:

Set connection metadata

• Node
• REST API

await nango.setMetadata(
    '<INTEGRATION-ID>', 
    '<CONNECTION-ID>', 
    { any_key: 'Any Value' }
);

Update connection metadata

• Node
• REST API

await nango.setMetadata(
    '<INTEGRATION-ID>', 
    '<CONNECTION-ID>', 
    { any_key: 'Any Value' }
);

Get connection metadata

• Node
• REST API

await nango.getMetadata('<INTEGRATION-ID>', '<CONNECTION-ID>');

Questions, problems, feedback? Please reach out in the Slack community.