CircleCI

🚀 Quickstart

Connect to CircleCI with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> CircleCI.

Authorize CircleCI

Go to Connections -> Add Test Connection -> Authorize, then enter your CircleCI personal API token. Later, you’ll let your users do the same directly from your app.

Call the CircleCI API

Let’s make your first request to the CircleCI API to get the user who owns the token. Replace the placeholders below with your Environment API key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/api/v2/me" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

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

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.get({
    endpoint: '/api/v2/me',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our quickstart to integrate Nango in your app.

📚 CircleCI integration guides

How do I link my account?
Create a CircleCI personal API token and connect it in the Connect UI.

Official docs: CircleCI API v2

🧩 Pre-built syncs & tools for CircleCI

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs. No pre-built syncs or tools available yet.

Not seeing the integration you need? Build your own independently.

API gotchas

The self-hosted runner API is on runner.circleci.com, not circleci.com. Set baseUrlOverride to https://runner.circleci.com for those calls; Nango keeps the connection’s credentials and headers. See CircleCI’s self-hosted runner API.

Overview

1,000+ APIs & Integrations

🚀 Quickstart

📚 CircleCI integration guides

🧩 Pre-built syncs & tools for CircleCI

API gotchas