[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77ZFFK1R13P9Z02YTH4K9VV":3,"skill-same:01M77ZFFK1R13P9Z02YTH4K9VV":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":29,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M77ZFFK1R13P9Z02YTH4K9VV","pm-braze",null,"Braze connector knowledge and safe action guide.","polymetrics-ai\u002Fcli","polymetrics-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F177650388?v=4","01M77Z920R1RTP5NXCP1V1HNMS","Polymetrics","01M77Z921DPWZC4DQSSZNWF82B",7,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fconnectors\u002Fbraze\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pm-braze\ndescription: Braze connector knowledge and safe action guide.\n---\n\n# pm-braze\n\n## Purpose\n\nReads Braze campaigns, Canvases, segments (list + per-id details\u002Fanalytics-summary), catalogs, content blocks, email templates, Content Cards, email bounce\u002Funsubscribe lists, SMS invalid-number lists, KPIs, sessions, preference centers, and scheduled broadcasts; writes user data (track\u002Fidentify\u002Fmerge\u002Falias\u002Fdelete), subscription-group status, catalog and catalog-item mutations, content block\u002Femail template mutations, email\u002FSMS compliance-list mutations, preference center mutations, and live message\u002Fcampaign\u002FCanvas sends through the Braze REST API. The events (custom event names) and purchases\u002Fproduct_list streams are not modeled by this bundle; see docs.md Known limits.\n\n## Icon\n\n- id: braze\n- asset: icons\u002Fbraze.svg\n- source: upstream_registry\n- review_status: upstream_seeded\n- review_url: https:\u002F\u002Fwww.braze.com\u002Fdocs\u002Fapi\u002Fhome\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- base_url (required)\n- mode\n- api_key (secret) (required)\n\n## ETL Streams\n\n- campaigns:\n  - primary key: id\n  - cursor: last_edited\n  - fields: id(string), is_api_campaign(boolean), last_edited(string), name(string), tags(array)\n- canvases:\n  - primary key: id\n  - cursor: last_edited\n  - fields: id(string), last_edited(string), name(string), tags(array)\n- segments:\n  - primary key: id\n  - fields: analytics_tracking_enabled(boolean), id(string), name(string), tags(array)\n- campaign_details:\n  - primary key: campaign_id\n  - fields: archived(boolean), campaign_id(string), channels(string), conversion_behaviors(array), created_at(string), description(string), draft(boolean), enabled(boolean), first_sent(string), has_post_launch_draft(boolean), last_sent(string), message(string), messages(object), name(string), schedule_type(string), tags(string), teams(string), updated_at(string)\n- canvas_details:\n  - primary key: canvas_id\n  - fields: archived(boolean), canvas_id(string), channels(array), created_at(string), description(string), draft(boolean), enabled(boolean), first_entry(string), last_entry(string), message(string), name(string), schedule_type(string), steps(array), tags(string), teams(string), updated_at(string), variants(array)\n- canvas_data_summary:\n  - primary key: canvas_id\n  - fields: canvas_id(string), data(array), message(string), name(string)\n- segment_details:\n  - primary key: segment_id\n  - fields: created_at(string), description(string), message(string), name(string), segment_id(string), tags(array), text_description(string), updated_at(string)\n- catalogs:\n  - primary key: name\n  - fields: description(string), fields(array), name(string), num_items(integer), updated_at(string)\n- content_blocks:\n  - primary key: content_block_id\n  - cursor: last_edited\n  - fields: content_block_id(string), content_type(string), created_at(string), inclusion_count(integer), last_edited(string), liquid_tag(string), name(string), tags(array)\n- email_templates:\n  - primary key: email_template_id\n  - cursor: updated_at\n  - fields: created_at(string), email_template_id(string), tags(string), template_name(string), updated_at(string)\n- feed_cards:\n  - primary key: id\n  - fields: id(string), tags(array), title(string), type(string)\n- email_hard_bounces:\n  - primary key: email, hard_bounced_at\n  - cursor: hard_bounced_at\n  - fields: email(string), hard_bounced_at(string)\n- email_unsubscribes:\n  - primary key: email, unsubscribed_at\n  - cursor: unsubscribed_at\n  - fields: email(string), unsubscribed_at(string)\n- sms_invalid_phone_numbers:\n  - primary key: phone, invalid_detected_at\n  - cursor: invalid_detected_at\n  - fields: invalid_detected_at(string), phone(string), reason(string)\n- kpi_dau:\n  - primary key: time\n  - cursor: time\n  - fields: dau(integer), time(string)\n- kpi_mau:\n  - primary key: time\n  - cursor: time\n  - fields: mau(integer), time(string)\n- kpi_new_users:\n  - primary key: time\n  - cursor: time\n  - fields: new_users(integer), time(string)\n- kpi_uninstalls:\n  - primary key: time\n  - cursor: time\n  - fields: time(string), uninstalls(integer)\n- sessions:\n  - primary key: time\n  - cursor: time\n  - fields: sessions(integer), time(string)\n- preference_centers:\n  - primary key: preference_center_api_id\n  - cursor: updated_at\n  - fields: created_at(string), name(string), preference_center_api_id(string), updated_at(string)\n- scheduled_broadcasts:\n  - primary key: id, next_send_time\n  - fields: id(string), name(string), next_send_time(string), schedule_type(string), tags(string), type(string)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped\n\n## Reverse ETL Actions\n\n- track_users:\n  - endpoint: POST \u002Fusers\u002Ftrack\n  - risk: records user attribute\u002Fevent\u002Fpurchase data in bulk (up to 75 events\u002Fattributes\u002Fpurchases per request per Braze's documented limit); an external user_id or user_alias in the record is the ONLY way Braze correlates the update to a user, so a mistargeted identifier silently attaches data to the wrong (or a newly-created) user profile\n- identify_users:\n  - endpoint: POST \u002Fusers\u002Fidentify\n  - risk: converts an anonymous\u002Faliased user profile into an identified one and can merge attribute\u002Fbehavior history onto the target identified profile; merge_behavior: merge combines the two profiles' full history irreversibly\n- delete_users:\n  - endpoint: POST \u002Fusers\u002Fdelete\n  - risk: permanently and irreversibly deletes user profiles and all their associated data (attributes, event\u002Fpurchase history, message engagement); Braze does not offer an undelete path\n- merge_users:\n  - endpoint: POST \u002Fusers\u002Fmerge\n  - required fields: merge_updates\n  - risk: irreversibly merges one user profile's full history into another and deletes the source profile identifier; up to 50 merge pairs per request per Braze's documented limit\n- create_user_alias:\n  - endpoint: POST \u002Fusers\u002Falias\u002Fnew\n  - required fields: user_aliases\n  - risk: creates new alias identifiers for existing (or new anonymous) user profiles; low-risk additive mutation, no approval required\n- update_user_alias:\n  - endpoint: POST \u002Fusers\u002Falias\u002Fupdate\n  - required fields: alias_updates\n  - risk: renames an existing alias identifier on a user profile; any external system correlating users by the old alias_name stops matching after this runs\n- remove_user_external_ids:\n  - endpoint: POST \u002Fusers\u002Fexternal_ids\u002Fremove\n  - required fields: external_ids\n  - risk: detaches an external_id from its user profile, converting that profile to anonymous; the profile itself is not deleted but becomes unreachable by the removed identifier\n- rename_user_external_ids:\n  - endpoint: POST \u002Fusers\u002Fexternal_ids\u002Frename\n  - required fields: external_id_renames\n  - risk: renames a user's external_id; any external system correlating users by the old id stops matching after this runs\n- set_subscription_status_v2:\n  - endpoint: POST \u002Fv2\u002Fsubscription\u002Fstatus\u002Fset\n  - required fields: subscription_groups\n  - risk: opts users into or out of an email\u002FSMS subscription group in bulk (up to 50 groups x 50 identifiers per Braze's documented limit); setting subscription_state to unsubscribed on a transactional-adjacent group can stop legally-required or expected communications reaching those users\n- create_catalog:\n  - endpoint: POST \u002Fcatalogs\n  - required fields: catalogs\n  - risk: creates a new catalog container with a fixed field schema; low-risk additive mutation, no approval required\n- delete_catalog:\n  - endpoint: DELETE \u002Fcatalogs\u002F{{ record.catalog_name }}\n  - required fields: catalog_name\n  - risk: permanently deletes a catalog and every item it contains; any campaign\u002FCanvas\u002FConnected Content template referencing this catalog by name starts failing to resolve\n- create_catalog_items:\n  - endpoint: POST \u002Fcatalogs\u002F{{ record.catalog_name }}\u002Fitems\n  - required fields: catalog_name, items\n  - risk: adds new rows (up to 50 per request per Braze's documented limit) to an existing catalog; low-risk additive mutation, no approval required\n- update_catalog_items:\n  - endpoint: PATCH \u002Fcatalogs\u002F{{ record.catalog_name }}\u002Fitems\n  - required fields: catalog_name, items\n  - risk: partially updates existing catalog rows in bulk by their id field; any Connected Content template or campaign personalization reading this catalog reflects the new values on its next fetch\n- update_catalog_item:\n  - endpoint: PATCH \u002Fcatalogs\u002F{{ record.catalog_name }}\u002Fitems\u002F{{ record.item_id }}\n  - required fields: catalog_name, item_id, items\n  - risk: partially updates a single existing catalog row; any Connected Content template or campaign personalization reading this catalog reflects the new value on its next fetch\n- delete_catalog_item:\n  - endpoint: DELETE \u002Fcatalogs\u002F{{ record.catalog_name }}\u002Fitems\u002F{{ record.item_id }}\n  - required fields: catalog_name, item_id\n  - risk: permanently removes a single row from a catalog; any Connected Content template or campaign personalization referencing this item_id starts returning no match\n- create_content_block:\n  - endpoint: POST \u002Fcontent_blocks\u002Fcreate\n  - required fields: name, content\n  - risk: creates a new reusable email Content Block; low-risk additive mutation, no approval required\n- update_content_block:\n  - endpoint: POST \u002Fcontent_blocks\u002Fupdate\n  - required fields: content_block_id\n  - risk: mutates an existing Content Block's markup\u002Ftext; changes are reflected in EVERY campaign\u002FCanvas\u002Ftemplate that includes this block on their next send, including already-scheduled sends\n- create_email_template:\n  - endpoint: POST \u002Ftemplates\u002Femail\u002Fcreate\n  - required fields: template_name, subject, body\n  - risk: creates a new reusable email template; low-risk additive mutation, no approval required\n- update_email_template:\n  - endpoint: POST \u002Ftemplates\u002Femail\u002Fupdate\n  - required fields: email_template_id\n  - risk: mutates an existing email template's subject\u002Fbody; changes are reflected in EVERY campaign using this template on its next send, including already-scheduled sends\n- create_email_blocklist:\n  - endpoint: POST \u002Femail\u002Fblocklist\n  - required fields: email\n  - risk: permanently blocklists email addresses from ever receiving Braze email again for this workspace; Braze's own docs note blocklisting cannot be undone via the API (requires a support request to reverse)\n- remove_email_hard_bounce:\n  - endpoint: POST \u002Femail\u002Fbounce\u002Fremove\n  - required fields: email\n  - risk: clears an email address's hard-bounced status, allowing future sends to resume; use only after confirming the underlying delivery issue is actually resolved, or the address will likely hard-bounce again and harm sender reputation\n- remove_email_spam:\n  - endpoint: POST \u002Femail\u002Fspam\u002Fremove\n  - required fields: email\n  - risk: clears an email address's spam-complaint status, allowing future sends to resume; reversing a genuine spam complaint risks another complaint and further sender-reputation damage\n- set_email_subscription_status:\n  - endpoint: POST \u002Femail\u002Fstatus\n  - required fields: email, subscription_state\n  - risk: changes a single email address's global subscription state (subscribed\u002Funsubscribed\u002Fopted_in); setting unsubscribed stops all future non-transactional email to that address\n- remove_sms_invalid_phone_numbers:\n  - endpoint: POST \u002Fsms\u002Finvalid_phone_numbers\u002Fremove\n  - required fields: phone_numbers\n  - risk: clears the invalid-number flag for phone numbers, allowing future SMS\u002FMMS sends to resume; use only after confirming the number can actually receive messages again, or it will likely be re-flagged and waste sending budget\n- create_preference_center:\n  - endpoint: POST \u002Fpreference_center\u002Fv1\n  - required fields: name, preference_center_title, preference_center_page_html, confirmation_page_html\n  - risk: publishes a new customer-facing preference center page (a live, externally-reachable URL once active); low-risk additive mutation but review the submitted HTML before use since it is served to end users verbatim\n- update_preference_center:\n  - endpoint: PUT \u002Fpreference_center\u002Fv1\u002F{{ record.preference_center_external_id }}\n  - required fields: preference_center_external_id, name, preference_center_title, preference_center_page_html, confirmation_page_html\n  - risk: overwrites an already-live, externally-reachable preference center page's HTML\u002Ftitle; visible to any end user who visits the page immediately after this runs\n- send_message:\n  - endpoint: POST \u002Fmessages\u002Fsend\n  - required fields: messages\n  - risk: immediately sends a live message (push\u002Femail\u002FSMS\u002Fwebhook\u002FContent Card) to the specified users, segment, or broadcast audience; irreversible once dispatched and the single riskiest write this connector exposes — always confirm the audience scope (segment_id\u002Faudience filter vs. an explicit small external_user_ids list) before use\n- trigger_campaign_send:\n  - endpoint: POST \u002Fcampaigns\u002Ftrigger\u002Fsend\n  - required fields: campaign_id\n  - risk: immediately dispatches an existing API-triggered campaign to the specified recipients\u002Faudience; irreversible once dispatched, always confirm the recipients\u002Faudience scope before use\n- trigger_canvas_send:\n  - endpoint: POST \u002Fcanvas\u002Ftrigger\u002Fsend\n  - required fields: canvas_id\n  - risk: immediately enters the specified recipients\u002Faudience into an existing API-triggered Canvas; irreversible once dispatched, always confirm the recipients\u002Faudience scope before use\n\n## Security\n\n- read risk: external Braze API read of campaign, Canvas, segment, catalog, content-block, template, Content-Card, email-compliance, SMS-compliance, KPI\u002Fsession, and preference-center metadata\n- write risk: external mutation of Braze user profiles (track\u002Fidentify\u002Fmerge\u002Fdelete\u002Falias), subscription-group membership, catalogs and catalog items, content blocks, email templates, email\u002FSMS compliance lists, preference centers, and live message\u002Fcampaign\u002FCanvas sends; send_message\u002Ftrigger_campaign_send\u002Ftrigger_canvas_send dispatch real, irreversible communications to end users and delete_users\u002Fremove_user_external_ids\u002Fcreate_email_blocklist are destructive — every write ships with an explicit per-action risk string\n- approval: required for destructive actions (delete_users, remove_user_external_ids, delete_catalog, delete_catalog_item, create_email_blocklist) and for any live send (send_message, trigger_campaign_send, trigger_canvas_send); catalog\u002Fcontent-block\u002Ftemplate\u002Fpreference-center create-update and compliance-list removals are lower-risk but still externally visible\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect braze\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect braze --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect braze before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n","# pm-braze\n\n## Purpose\n\nReads Braze campaigns, Canvases, segments (list + per-id details\u002Fanalytics-summary), catalogs, content blocks, email templates, Content Cards, email bounce\u002Funsubscribe lists, SMS invalid-number lists, KPIs, sessions, preference centers, and scheduled broadcasts; writes user data (track\u002Fidentify\u002Fmerge\u002Falias\u002Fdelete), subscription-group status, catalog and catalog-item mutations, content block\u002Femail template mutations, email\u002FSMS compliance-list mutations, preference center mutations, and live message\u002Fcampaign\u002FCanvas sends through the Braze REST API. The events (custom event names) and purchases\u002Fproduct_list streams are not modeled by this bundle; see docs.md Known limits.\n\n## Icon\n\n- id: braze\n- asset: icons\u002Fbraze.svg\n- source: upstream_registry\n- review_status: upstream_seeded\n- review_url: https:\u002F\u002Fwww.braze.com\u002Fdocs\u002Fapi\u002Fhome\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- base_url (required)\n- mode\n- api_key (secret) (required)\n\n## ETL Streams\n\n- campaigns:\n  - primary key: id\n  - cursor: last_edited\n  - fields: id(string), is_api_campaign(boolean), last_edited(string), name(string), tags(array)\n- canvases:\n  - primary key: id\n  - cursor: last_edited\n  - fields: id(string), last_edited(string), name(string), tags(array)\n- segments:\n  - primary key: id\n  - fields: analytics_tracking_enabled(boolean), id(string), name(string), tags(array)\n- campaign_details:\n  - primary key: campaign_id\n  - fields: archived(boolean), campaign_id(string), channels(string), conversion_behaviors(array), created_at(string), description(string), draft(boolean), enabled(boolean), first_sent(string), has_post_launch_draft(boolean), last_sent(string), message(string), messages(object), name(string), schedule_type(string), tags(string), teams(string), updated_at(string)\n- canvas_details:\n  - primary key: canvas_id\n  - fields: archived(boolean), canvas_id(string), channels(array), created_at(string), description(string), draft(boolean), enabled(boolean), first_entry(string), last_entry(string), message(string), name(string), schedule_type(string), steps(array), tags(string), teams(string), updated_at(string), variants(array)\n- canvas_data_summary:\n  - primary key: canvas_id\n  - fields: canvas_id(string), data(array), message(string), name(string)\n- segment_details:\n  - primary key: segment_id\n  - fields: created_at(string), description(string), message(string), name(string), segment_id(string), tags(array), text_description(string), updated_at(string)\n- catalogs:\n  - primary key: name\n  - fields: description(string), fields(array), name(string), num_items(integer), updated_at(string)\n- content_blocks:\n  - primary key: content_block_id\n  - cursor: last_edited\n  - fields: content_block_id(string), content_type(string), created_at(string), inclusion_count(integer), last_edited(string), liquid_tag(string), name(string), tags(array)\n- email_templates:\n  - primary key: email_template_id\n  - cursor: updated_at\n  - fields: created_at(string), email_template_id(string), tags(string), template_name(string), updated_at(string)\n- feed_cards:\n  - primary key: id\n  - fields: id(string), tags(array), title(string), type(string)\n- email_hard_bounces:\n  - primary key: email, hard_bounced_at\n  - cursor: hard_bounced_at\n  - fields: email(string), hard_bounced_at(string)\n- email_unsubscribes:\n  - primary key: email, unsubscribed_at\n  - cursor: unsubscribed_at\n  - fields: email(string), unsubscribed_at(string)\n- sms_invalid_phone_numbers:\n  - primary key: phone, invalid_detected_at\n  - cursor: invalid_detected_at\n  - fields: invalid_detected_at(string), phone(string), reason(string)\n- kpi_dau:\n  - primary key: time\n  - cursor: time\n  - fields: dau(integer), time(string)\n- kpi_mau:\n  - primary key: time\n  - cursor: time\n  - fields: mau(integer), time(string)\n- kpi_new_users:\n  - primary key: time\n  - cursor: time\n  - fields: new_users(integer), time(string)\n- kpi_uninstalls:\n  - primary key: time\n  - cursor: time\n  - fields: time(string), uninstalls(integer)\n- sessions:\n  - primary key: time\n  - cursor: time\n  - fields: sessions(integer), time(string)\n- preference_centers:\n  - primary key: preference_center_api_id\n  - cursor: updated_at\n  - fields: created_at(string), name(string), preference_center_api_id(string), updated_at(string)\n- scheduled_broadcasts:\n  - primary key: id, next_send_time\n  - fields: id(string), name(string), next_send_time(string), schedule_type(string), tags(string), type(string)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped\n\n## Reverse ETL Actions\n\n- track_users:\n  - endpoint: POST \u002Fusers\u002Ftrack\n  - risk: records user attribute\u002Fevent\u002Fpurchase data in bulk (up to 75 events\u002Fattributes\u002Fpurchases per request per Braze's documented limit); an external user_id or user_alias in the record is the ONLY way Braze correlates the update to a user, so a mistargeted identifier silently attaches data to the wrong (or a newly-created) user profile\n- identify_users:\n  - endpoint: POST \u002Fusers\u002Fidentify\n  - risk: converts an anonymous\u002Faliased user profile into an identified one and can merge attribute\u002Fbehavior history onto the target identified profile; merge_behavior: merge combines the two profiles' full history irreversibly\n- delete_users:\n  - endpoint: POST \u002Fusers\u002Fdelete\n  - risk: permanently and irreversibly deletes user profiles and all their associated data (attributes, event\u002Fpurchase history, message engagement); Braze does not offer an undelete path\n- merge_users:\n  - endpoint: POST \u002Fusers\u002Fmerge\n  - required fields: merge_updates\n  - risk: irreversibly merges one user profile's full history into another and deletes the source profile identifier; up to 50 merge pairs per request per Braze's documented limit\n- create_user_alias:\n  - endpoint: POST \u002Fusers\u002Falias\u002Fnew\n  - required fields: user_aliases\n  - risk: creates new alias identifiers for existing (or new anonymous) user profiles; low-risk additive mutation, no approval required\n- update_user_alias:\n  - endpoint: POST \u002Fusers\u002Falias\u002Fupdate\n  - required fields: alias_updates\n  - risk: renames an existing alias identifier on a user profile; any external system correlating users by the old alias_name stops matching after this runs\n- remove_user_external_ids:\n  - endpoint: POST \u002Fusers\u002Fexternal_ids\u002Fremove\n  - required fields: external_ids\n  - risk: detaches an external_id from its user profile, converting that profile to anonymous; the profile itself is not deleted but becomes unreachable by the removed identifier\n- rename_user_external_ids:\n  - endpoint: POST \u002Fusers\u002Fexternal_ids\u002Frename\n  - required fields: external_id_renames\n  - risk: renames a user's external_id; any external system correlating users by the old id stops matching after this runs\n- set_subscription_status_v2:\n  - endpoint: POST \u002Fv2\u002Fsubscription\u002Fstatus\u002Fset\n  - required fields: subscription_groups\n  - risk: opts users into or out of an email\u002FSMS subscription group in bulk (up to 50 groups x 50 identifiers per Braze's documented limit); setting subscription_state to unsubscribed on a transactional-adjacent group can stop legally-required or expected communications reaching those users\n- create_catalog:\n  - endpoint: POST \u002Fcatalogs\n  - required fields: catalogs\n  - risk: creates a new catalog container with a fixed field schema; low-risk additive mutation, no approval required\n- delete_catalog:\n  - endpoint: DELETE \u002Fcatalogs\u002F{{ record.catalog_name }}\n  - required fields: catalog_name\n  - risk: permanently deletes a catalog and every item it contains; any campaign\u002FCanvas\u002FConnected Content template referencing this catalog by name starts failing to resolve\n- create_catalog_items:\n  - endpoint: POST \u002Fcatalogs\u002F{{ record.catalog_name }}\u002Fitems\n  - required fields: catalog_name, items\n  - risk: adds new rows (up to 50 per request per Braze's documented limit) to an existing catalog; low-risk additive mutation, no approval required\n- update_catalog_items:\n  - endpoint: PATCH \u002Fcatalogs\u002F{{ record.catalog_name }}\u002Fitems\n  - required fields: catalog_name, items\n  - risk: partially updates existing catalog rows in bulk by their id field; any Connected Content template or campaign personalization reading this catalog reflects the new values on its next fetch\n- update_catalog_item:\n  - endpoint: PATCH \u002Fcatalogs\u002F{{ record.catalog_name }}\u002Fitems\u002F{{ record.item_id }}\n  - required fields: catalog_name, item_id, items\n  - risk: partially updates a single existing catalog row; any Connected Content template or campaign personalization reading this catalog reflects the new value on its next fetch\n- delete_catalog_item:\n  - endpoint: DELETE \u002Fcatalogs\u002F{{ record.catalog_name }}\u002Fitems\u002F{{ record.item_id }}\n  - required fields: catalog_name, item_id\n  - risk: permanently removes a single row from a catalog; any Connected Content template or campaign personalization referencing this item_id starts returning no match\n- create_content_block:\n  - endpoint: POST \u002Fcontent_blocks\u002Fcreate\n  - required fields: name, content\n  - risk: creates a new reusable email Content Block; low-risk additive mutation, no approval required\n- update_content_block:\n  - endpoint: POST \u002Fcontent_blocks\u002Fupdate\n  - required fields: content_block_id\n  - risk: mutates an existing Content Block's markup\u002Ftext; changes are reflected in EVERY campaign\u002FCanvas\u002Ftemplate that includes this block on their next send, including already-scheduled sends\n- create_email_template:\n  - endpoint: POST \u002Ftemplates\u002Femail\u002Fcreate\n  - required fields: template_name, subject, body\n  - risk: creates a new reusable email template; low-risk additive mutation, no approval required\n- update_email_template:\n  - endpoint: POST \u002Ftemplates\u002Femail\u002Fupdate\n  - required fields: email_template_id\n  - risk: mutates an existing email template's subject\u002Fbody; changes are reflected in EVERY campaign using this template on its next send, including already-scheduled sends\n- create_email_blocklist:\n  - endpoint: POST \u002Femail\u002Fblocklist\n  - required fields: email\n  - risk: permanently blocklists email addresses from ever receiving Braze email again for this workspace; Braze's own docs note blocklisting cannot be undone via the API (requires a support request to reverse)\n- remove_email_hard_bounce:\n  - endpoint: POST \u002Femail\u002Fbounce\u002Fremove\n  - required fields: email\n  - risk: clears an email address's hard-bounced status, allowing future sends to resume; use only after confirming the underlying delivery issue is actually resolved, or the address will likely hard-bounce again and harm sender reputation\n- remove_email_spam:\n  - endpoint: POST \u002Femail\u002Fspam\u002Fremove\n  - required fields: email\n  - risk: clears an email address's spam-complaint status, allowing future sends to resume; reversing a genuine spam complaint risks another complaint and further sender-reputation damage\n- set_email_subscription_status:\n  - endpoint: POST \u002Femail\u002Fstatus\n  - required fields: email, subscription_state\n  - risk: changes a single email address's global subscription state (subscribed\u002Funsubscribed\u002Fopted_in); setting unsubscribed stops all future non-transactional email to that address\n- remove_sms_invalid_phone_numbers:\n  - endpoint: POST \u002Fsms\u002Finvalid_phone_numbers\u002Fremove\n  - required fields: phone_numbers\n  - risk: clears the invalid-number flag for phone numbers, allowing future SMS\u002FMMS sends to resume; use only after confirming the number can actually receive messages again, or it will likely be re-flagged and waste sending budget\n- create_preference_center:\n  - endpoint: POST \u002Fpreference_center\u002Fv1\n  - required fields: name, preference_center_title, preference_center_page_html, confirmation_page_html\n  - risk: publishes a new customer-facing preference center page (a live, externally-reachable URL once active); low-risk additive mutation but review the submitted HTML before use since it is served to end users verbatim\n- update_preference_center:\n  - endpoint: PUT \u002Fpreference_center\u002Fv1\u002F{{ record.preference_center_external_id }}\n  - required fields: preference_center_external_id, name, preference_center_title, preference_center_page_html, confirmation_page_html\n  - risk: overwrites an already-live, externally-reachable preference center page's HTML\u002Ftitle; visible to any end user who visits the page immediately after this runs\n- send_message:\n  - endpoint: POST \u002Fmessages\u002Fsend\n  - required fields: messages\n  - risk: immediately sends a live message (push\u002Femail\u002FSMS\u002Fwebhook\u002FContent Card) to the specified users, segment, or broadcast audience; irreversible once dispatched and the single riskiest write this connector exposes — always confirm the audience scope (segment_id\u002Faudience filter vs. an explicit small external_user_ids list) before use\n- trigger_campaign_send:\n  - endpoint: POST \u002Fcampaigns\u002Ftrigger\u002Fsend\n  - required fields: campaign_id\n  - risk: immediately dispatches an existing API-triggered campaign to the specified recipients\u002Faudience; irreversible once dispatched, always confirm the recipients\u002Faudience scope before use\n- trigger_canvas_send:\n  - endpoint: POST \u002Fcanvas\u002Ftrigger\u002Fsend\n  - required fields: canvas_id\n  - risk: immediately enters the specified recipients\u002Faudience into an existing API-triggered Canvas; irreversible once dispatched, always confirm the recipients\u002Faudience scope before use\n\n## Security\n\n- read risk: external Braze API read of campaign, Canvas, segment, catalog, content-block, template, Content-Card, email-compliance, SMS-compliance, KPI\u002Fsession, and preference-center metadata\n- write risk: external mutation of Braze user profiles (track\u002Fidentify\u002Fmerge\u002Fdelete\u002Falias), subscription-group membership, catalogs and catalog items, content blocks, email templates, email\u002FSMS compliance lists, preference centers, and live message\u002Fcampaign\u002FCanvas sends; send_message\u002Ftrigger_campaign_send\u002Ftrigger_canvas_send dispatch real, irreversible communications to end users and delete_users\u002Fremove_user_external_ids\u002Fcreate_email_blocklist are destructive — every write ships with an explicit per-action risk string\n- approval: required for destructive actions (delete_users, remove_user_external_ids, delete_catalog, delete_catalog_item, create_email_blocklist) and for any live send (send_message, trigger_campaign_send, trigger_canvas_send); catalog\u002Fcontent-block\u002Ftemplate\u002Fpreference-center create-update and compliance-list removals are lower-risk but still externally visible\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect braze\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect braze --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect braze before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n",{"name":5,"description":7},"main","813f457a925f7ee3fe3bea101a43e445992c8552","docs\u002Fconnectors\u002Fbraze",0,"https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli","https:\u002F\u002Fcli.polymetrics.ai","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai","Local-first data infrastructure for agents and developers.","2026-09-21 12:42:03",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add polymetrics-ai\u002Fcli --skill pm-braze",{"tool":39,"command":40},"bunx","bunx skills add polymetrics-ai\u002Fcli --skill pm-braze",{"tool":42,"command":43},"pnpm","pnpm dlx skills add polymetrics-ai\u002Fcli --skill pm-braze","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fconnectors\u002Fbraze\u002FSKILL.md",true,[47],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"MANUAL.md","REFERENCE","参考文档",15492,"https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fconnectors\u002Fbraze\u002FMANUAL.md",[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M782EH9BFHYZVECKJ31F427S","recipe-preview-approve-reverse-etl","Preview and approve a reverse ETL plan safely.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-preview-approve-reverse-etl\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M782EFGH5NRZ2CXDK0V9YWFW","recipe-github-prs-to-warehouse","Sync GitHub pull requests into the local warehouse.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-github-prs-to-warehouse\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M782ECJZRQAK8E86CE7R2YM2","pm-zoom","Zoom connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoom\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M782EASYDANMV35W2ZHG2QD0","pm-zonka-feedback","Zonka Feedback connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zonka-feedback\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M782E8WA94A906385AET1ZWH","pm-zoho-invoice","Zoho Invoice connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-invoice\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M782E73M7F23B6VBGM72QMMQ","pm-zoho-inventory","Zoho Inventory connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-inventory\u002FSKILL.md",[],[]]