AI agents with Loops webhooks

Receive Loops webhooks on Trigger.dev and use them to start, resume or message your AI agents.

Get started now

What you can do with Loops webhooks

Start an agent

Loops events can start a new agent run. For example, an agent that cleans up contacts whose Loops emails bounce.

Resume an agent

An agent can pause until the Loops event it needs arrives, for up to 90 days, and costs nothing while it waits.

Message an agent

Loops events can land in a running agent's conversation, so it acts on them with full context.

Events you can receive from Loops

Some of the events Loops sends. Your agent can filter on any of them.

contact.created

Contact created

contact.mailingList.subscribed

Contact subscribed to mailing list

transactional.email.sent

Transactional email sent

email.delivered

Email delivered

email.hardBounced

Email hard bounced

email.clicked

Email link clicked

testing.testEvent

Test event sent from Loops settings

contact.unsubscribed

Example

An agent that cleans up contacts whose Loops emails bounce

import { webhook, webhooks } from "@trigger.dev/sdk";
export const loops = webhooks.endpoint.define({
id: "loops",
source: webhooks.loops(),
});
export const loopsEvents = webhook({
id: "loops-events",
endpoint: loops,
filter: "event.eventName == 'email.hardBounced'",
onEvent: async ({ event }) => {
// Start, resume or message your agent with the event
console.log(event);
},
});

Handled for you

Verified for you

webhooks.loops() checks the Loops signature on every request. Bad requests are rejected before anything runs.

Retries don't run twice

Retries are matched on the webhook-id header, so a retried webhook doesn't start a second run.

Filter before anything runs

Only the Loops events you care about start a run. Filtered webhooks use no compute.

See every delivery

Every webhook is recorded with its payload, headers and the agents it reached, so you can debug it and replay it.

Get started

  1. 1

    Set up the agent

    Copy the starter prompt into your coding agent, like Claude Code, Cursor or Codex. It creates a Trigger.dev project and adds the webhook endpoint. Prefer to write it yourself? Start from the example above.

  2. 2

    Add the webhook in Loops

    Deploy your project, or run trigger dev, and the endpoint appears on the Webhooks page of the Trigger.dev dashboard with its URL. Add that URL in Loops's webhook settings and pick the events you need. The endpoint's Copy setup prompt button gives your coding agent the exact steps.

  3. 3

    Add Loops's signing secret

    Copy the signing secret from Loops. Then on the endpoint's page in the Trigger.dev dashboard, choose Set signing secret and paste it in, so Trigger.dev can check every request really came from Loops.

  4. 4

    Try it

    Send a test event from Loops, or use the endpoint's Test tab. It appears on the endpoint's Deliveries tab, with the agents it reached.

Related integrations

Ready to build with Loops webhooks?

Declare an endpoint, deploy, and paste the URL into your provider.

Get started for free