View as Markdown
CircleCI icon

CircleCI TRIGGER

New Job Completed (Instant)

Emit new event when a job is completed in CircleCI.
  • Trigger
  • Instant
  • API key
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's CircleCI account, configure the source, and choose the webhook where your backend receives events.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const deployed = await pd.triggers.deploy({
  id: "circleci-new-job-completed-instant",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    circleci: { authProvisionId: "apn_xxxxxxx" },
    name: "Webhook Name",
    projectId: "Project ID",
  },
  webhookUrl: "https://example.com/webhooks/circleci",
})

console.log(deployed.id)

MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.

SCHEMA

Configuration

These inputs define which events the source watches. Dynamic options are loaded from the connected account.

New Job Completed (Instant) configuration
Property Type Description
name Webhook Name string
Name of the webhook
Required
projectId Project ID string
The identifier of a project. Can be found in Project Settings -> Overview
Required

01

Connect

Your user authorizes CircleCI through Pipedream managed auth.

02

Deploy

Your backend deploys this source with that user's own configuration.

03

Webhook delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source — as it happens.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
circleci-new-job-completed-instant
Version
0.0.1
App
CircleCI
Authentication
API key
Delivery
Instant event
Output
Events emitted by CircleCI.