- Trigger workflows from any pull subscription using the Google Pub/Sub Message Received trigger.
- Publish messages to topics from inside a workflow using the Publish to Pub/Sub node.
Authentication
The integration uses service-account credentials only. OAuth user tokens don’t pair naturally with Pub/Sub IAM, and supporting them would require constant token-refresh juggling for what is effectively backend infrastructure.1
Create a Google Cloud service account
In Google Cloud Console, open IAM & Admin → Service Accounts in the project that owns your Pub/Sub topics and subscriptions. Create a service account dedicated to Noxus (e.g.
noxus-pubsub@MY_PROJECT.iam.gserviceaccount.com).Click Keys → Add Key → Create new key → JSON to download the JSON key file.2
Enable the Pub/Sub API
On the same Google Cloud project, open APIs & Services → Library, search for Cloud Pub/Sub API, and click Enable if it’s not already on.
3
Connect the credential in Noxus
In Noxus, open Connections → Add connection → Google Pub/Sub. Paste the entire contents of the JSON key file into Service account JSON and click Connect.Noxus mints a token from the key, hits the Pub/Sub API in your project, and surfaces a validation error if anything is wrong (disabled SA, missing API, blocked project, etc.). On success the integration card shows the connected SA’s email and project ID.
The service account just authenticates — it doesn’t grant access to anything by itself. You still need to grant per-resource IAM roles on each topic or subscription the integration touches (see below).
IAM grants
Two IAM roles, granted on different resources depending on which surface you’re using:
Activate-time validation catches missing grants on the trigger side; for the publish node the error surfaces on the first publish call with an actionable message.
Workflow trigger: Pub/Sub Message Received
ABaseConsumerTrigger-backed workflow trigger that holds a persistent streaming-pull connection to a customer-owned pull subscription. Every published message starts a fresh workflow run.
Configuration
Output fields
The trigger emits these fields into each workflow run; bind any of them to your workflow’s input connectors:Delivery semantics
- At-least-once delivery. Pub/Sub can redeliver a message if Noxus crashes after receiving but before ack’ing. The trigger dedups on
message_id(5-minute cache) so the workflow runs exactly once in practice. - Ack-after-commit. Messages are only ack’d after the workflow event row is durably committed. A relay crash mid-processing causes Pub/Sub to redeliver, which the dedup cache absorbs.
- Concurrency cap. Each subscription’s stream is bounded at 20 in-flight messages so a flooded subscription can’t starve other consumers in the same relay process.
- Failure visibility. IAM errors, NotFound, Unauthenticated, and generic failures surface on the Deployment Events tab (and in the workflow’s run history) with the exception class and message — you don’t need to read relay logs.
Workflow node: Publish to Pub/Sub
Publishes a single message to a topic from inside a workflow. Common patterns: emit “order processed” events, send notifications to a downstream pipeline, push to a queue for an external worker.Configuration
Inputs
Output
Error handling
The node classifies the most common Pub/Sub failures into actionable messages:PermissionDenied→ “Service account cannot publish to ’…’. Grantroles/pubsub.publisheron the topic.” Includes the underlying SDK error for debugging.NotFound→ “Pub/Sub topic ’…’ does not exist.” Verify the project ID and topic name.- Anything else → wrapped in
IntegrationFailedErrorwith the exception class name + first 200 chars so the workflow’s run log shows what failed without leaking raw gRPC traces.
Example workflow
A simple “process an order and emit a downstream event” flow:Troubleshooting
Trigger activates but no messages arrive
Trigger activates but no messages arrive
Verify the publisher side: the role grant on the subscription only covers consumption, not publishing. If no one is publishing to the topic, the subscription stays empty. Confirm with:If this returns messages, the trigger is misconfigured. If it returns nothing, the publisher isn’t sending.
Trigger activation fails with 'cannot consume from'
Trigger activation fails with 'cannot consume from'
The connected service account is missing
roles/pubsub.subscriber on the subscription. The error message names the exact SA email and subscription path. Grant the role and retry activation.Publish node fails with 'cannot publish to'
Publish node fails with 'cannot publish to'
The connected service account is missing
roles/pubsub.publisher on the topic (not the subscription). Grant the role and re-run the workflow.Pasted a topic in the subscription field (or vice versa)
Pasted a topic in the subscription field (or vice versa)
Topics and subscriptions are different resources. Pub/Sub publishes to topics; consumers pull from subscriptions on those topics. The Noxus form validates the resource type and explicitly tells you when the wrong one was pasted.
Activation succeeds but events never trigger the workflow
Activation succeeds but events never trigger the workflow
Pub/Sub guarantees at-least-once delivery; if your subscription has no
ackDeadlineSeconds or it’s set very short, the broker may redeliver before the workflow run starts and you’ll see duplicates rather than missing runs. Default subscription settings (10s ack deadline, with the SDK auto-extending) work correctly with Noxus’ ack-after-commit semantics.Google Workspace
Gmail, Drive, Sheets, Docs, Calendar
Google Chat (Pub/Sub mode)
Receive Chat events via Pub/Sub when a public webhook isn’t an option
Triggers
All workflow trigger types
Authentication
OAuth and service-account setup