Pre-requisite: creation of an integration and at least one connection (step-by-step guide).

The Proxy lets you query external APIs easily with credentials injection, request logging, and pre-configurations for base URLs, rate-limits, retries, etc.

Here is an example of how to query external APIs with the proxy, using the SDK (reference) and API (reference):

try {
    const res = await nango.proxy({
        method: 'POST',
        baseUrlOverride: '',
        endpoint: '/external-endpoint',
        providerConfigKey: '<string>',
        connectionId: '<string>',
        retries: 5, // Retries with exponential backoff (optional, default 0)
        data: {
            id: 1,
            colorId: 'blue',
            selected: true

    // Response was 200!
    // See
} catch (error) {
    // Status of response != 200
    // See

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