First-party app
Braze

Braze

Track user data, trigger campaigns and Canvases, send messages, and manage email subscriptions in Braze.

stable MarketingCommunication

About

Braze ships in the w6w first-party pack. It declares 22 actions, 2 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.braze
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Marketing · Communication

Overview

Braze is a customer engagement platform that runs cross-channel marketing automation — email, push, SMS, in-app, and Canvas multi-step journeys — off a single user profile. This app covers the operations a workflow most needs around that profile and its outbound messaging: track custom events, purchases, and attribute updates onto a user; resolve aliases and identities; export full profiles; and delete users on request.

On the sending side, it triggers API-triggered Campaign and Canvas sends against an audience filter or an explicit recipient list, and sends immediate ad-hoc messages outside of any saved campaign. It manages email subscription state directly and reads back hard bounces and unsubscribes, and it reads and writes the supporting content a campaign is built from — Content Blocks and catalogs — plus lists campaigns, Canvases, and segments for discovery.

Braze runs each customer’s workspace on one of several fixed regional clusters rather than a single API host, and a REST key from one cluster is rejected by every other, so the app asks which instance a Connection is on rather than guessing.

Build with Braze

Three routes to the same 22 actions. The Workflow tab is generated from Braze's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Get Campaign Details

campaign-details-get

Fetch full configuration and channel details for one campaign.

List Campaigns

campaign-list

Export the list of campaigns in the workspace.

Trigger Campaign Send

campaign-trigger-send

Send an API-triggered campaign to an audience and/or explicit recipients.

Get Canvas Details

canvas-details-get

Fetch full configuration and step details for one Canvas.

List Canvases

canvas-list

Export the list of Canvases in the workspace.

Trigger Canvas Send

canvas-trigger-send

Enter an audience into an API-triggered Canvas.

List Catalog Items

catalog-item-list

List every item in a catalog.

List Catalogs

catalog-list

List every catalog defined in the workspace, with field schemas and item counts.

Create Content Block

content-block-create

Create a reusable HTML/text Content Block.

Get Content Block

content-block-get

Fetch a single Content Block's body and metadata.

List Content Blocks

content-block-list

List reusable Content Blocks in the workspace.

List Hard Bounced Emails

email-hard-bounces-list

Query email addresses that have hard bounced, optionally in a date range.

Set Email Subscription Status

email-status-set

Subscribe, unsubscribe, or opt an email address out of subscribed messaging.

List Unsubscribed Emails

email-unsubscribes-list

Query email addresses that have unsubscribed, optionally in a date range.

Send Message

message-send

Send an immediate, ad-hoc message across one or more channels.

List Segments

segment-list

Export the list of segments in the workspace.

List Invalid Phone Numbers

sms-invalid-phone-number-list

Query phone numbers Braze has found undeliverable, by date range or explicit list.

Create User Alias

user-alias-new

Attach a new alias to an existing external ID.

Delete Users

user-delete

Delete one or more users by external ID, Braze ID, or alias.

Export User Profiles

user-export-ids

Export full user profiles by external ID, alias, device ID, Braze ID, or contact.

Identify User

user-identify

Resolve an alias, email, or phone number onto a known external ID.

Track User

user-track

Record custom events, purchases, and attribute updates for one or more users.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Braze's real ids.

{
  "manifestVersion": "2",
  "name": "braze-example",
  "steps": [
    {
      "id": "campaign-details-get",
      "uses": {
        "app": "io.w6w.braze",
        "action": "campaign-details-get",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "campaignId": "<campaignId>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Campaign Details

    read
    campaign-details-get
  • List Campaigns

    read
    campaign-list
  • Trigger Campaign Send

    perform
    campaign-trigger-send
  • Get Canvas Details

    read
    canvas-details-get
  • List Canvases

    read
    canvas-list

+17 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Braze, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Braze. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "campaign-details-get",
  payload: {
    campaignId: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action campaign-details-get --payload '{"campaignId":"<value>"}'

Give an AI agent Braze — without giving it Braze's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.braze#campaign-details-get",
    "input": {
      "campaignId": "<campaignId>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Braze connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Braze's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Braze itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Braze declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Braze platform status

The REST APIs component for THIS connection's cluster on Braze's status page. Reads the Connection for the instance; sends no credential.

quota

Rate-limit headroom