Pre-requisite: configure Nango.

Activate an action integration

Nango uses actions to perform tasks synchoronously 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.

Your use case is not covered by the available pre-built integrations? Use the custom integration builder.

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> }'

If you consume the API (vs. the SDK), you can use the standard endpoint (above) or a unique generated endpoint described in the Endpoints tab of your integration in the Nango UI. The generated endpoint documents the specific parameters & responses of each action.

Troubleshoot errors & monitor

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

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