​

Activate an action integration

Nango uses actions to perform tasks synchronously involving external APIs. Tasks can involve arbitrary series of API requests & data transformations. For common use cases, pre-built action integrations are available to let you get started fast.

Select your integration in the Integrations tab, and navigate to the Endpoints tab. Available pre-built action integrations will appear in the endpoint list. Select the relevant one and enable it with the toggle.

​

Trigger an action

Actions can take inputs, and they return a result synchronously. Trigger actions using the backend SDK (reference) or API (reference):

curl --request POST \
  --url https://api.nango.dev/action/trigger \
  --header 'Authorization: Bearer <PROJECT-SECRET-KEY>' \
  --header 'Connection-Id: <string>' \
  --header 'Provider-Config-Key: <string>' \
  --data '{ "action_name": "<string>", "input": <json> }'

curl --request POST \
  --url https://api.nango.dev/action/trigger \
  --header 'Authorization: Bearer <PROJECT-SECRET-KEY>' \
  --header 'Connection-Id: <string>' \
  --header 'Provider-Config-Key: <string>' \
  --data '{ "action_name": "<string>", "input": <json> }'

import { Nango }  from '@nangohq/node';

const nango = new Nango({ secretKey: '<PROJECT-SECRET-KEY>' });

const result = await nango.triggerAction('<INTEGRATION-ID>', '<CONNECTION-ID>', '<ACTION-NAME>', jsonInput);

​

Troubleshoot errors & monitor

Navigate to the Logs tab to inspect potential errors & monitor action executions.