Get Mapbox embeds after README updates
Keep a ready-to-share map embed close to the documentation change that needs it.
Trigger
GitHub Repository README Changed
Triggers when the README file in a specific repository directory changes. Monitors the README in a configurable directory and branch/tag/commit. The payload includes the current README metadata (filename, path, SHA, size, URLs), the previous and current git blob SHAs, and a list of which tracked fields changed.
Action
Request Style Embed HTML
Tool to retrieve embeddable html for a mapbox style. use when you want to embed a style in an iframe after verifying access.
Why this helps
A map documentation edit can create a small but easy-to-forget request for the right embed code.
- Keeps docs follow-up together
- Retrieves embed HTML on demand
- Reduces handoff friction
Setup
Build it in a few focused steps.
- 1Connect GitHub and Mapbox to Notis once.
- 2Create a new portal automation.
- 3Tell Notis to retrieve the approved style embed when the README map guidance changes.
- 4Pick GitHub Repository README Changed and a report channel.
- 5Test by updating the relevant README.
Questions about this workflow
Do I need to paste embed code into a field?
No. Ask Notis for the outcome in the automation prompt.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link GitHub to Mapbox. A trigger fires from one place; an action lands in another.
GitHub triggers
Mapbox actions
New Workflow Artifact Created
Triggers when a new workflow artifact is created in a GitHub repository. Monitors for newly created GitHub Actions workflow artifacts. Optionally filters by artifact name to restrict monitoring to specific artifacts.
Batch Geocoding
Tool to perform batch forward or reverse geocoding for multiple locations. use when you need consistent geocoding of up to 50 queries in one call.
Branch Changed
Triggers when a GitHub branch changes. Monitors a specific branch for: - New commits pushed (head commit SHA changes) - Protection status toggled (branch becomes protected or unprotected) - Protection settings changed, including: required status checks and their enforcement level, admin enforcement, required pull request reviews (dismiss stale reviews, code owner reviews, approving review count, last push approval), required linear history, force push allowance, deletion allowance, conversation resolution, branch locking, and fork syncing.
Forward Geocoding
Tool to convert free-form or structured address into geographic coordinates and place features. use when you need forward geocoding from text or address components.
New Branch Created
Triggers when a new branch is created in a GitHub repository. Detects newly created branches. Deleted branches do not fire events.
Permanent Forward Geocoding
Tool to perform permanent forward geocoding. use when you need enterprise-grade permanent geocoding after confirming account privileges.
Check Run Status / Conclusion Changed
Triggers when a specific GitHub check run changes its status or conclusion. Monitors a single check run for changes to: status (queued, in_progress, completed, etc.), conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required), started_at, and completed_at.
Permanent Reverse Geocoding
Tool to perform permanent reverse geocoding. use after obtaining coordinates to get cacheable place data. example: lon=-73.989, lat=40.733
Check Suite Status / Conclusion Changed
Triggers when a GitHub check suite changes its status or conclusion for a given ref. Monitors all check suites associated with a git reference (branch, tag, or commit SHA) for changes to status (queued, in_progress, completed, etc.) and conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required, startup_failure, stale). Optionally filters by GitHub App ID.
Reverse Geocoding
Tool to reverse geocode coordinates into place names. use after obtaining coordinates.
New Code Scanning Alert Created
Triggers when a new code scanning alert is created in a repository. Fires an event for each newly created code scanning alert detected in the configured repository. Alerts can be filtered by Git reference, scanning tool, state, and severity. The payload includes the alert number, rule details, tool information, state, severity, and the location of the most recent instance.
Get Access Token
Tool to extract and validate mapbox access token from connection metadata. use when you need a valid token for downstream actions.
New Repository Collaborator Added
Triggers when a new collaborator is added to a GitHub repository. Monitors the full list of collaborators on a repository and fires an event for each newly added collaborator. The payload includes the collaborator's GitHub username, account ID, profile URL, avatar URL, permission flags (pull, triage, push, maintain, admin), and assigned role name.
Request Style Embed HTML
Tool to retrieve embeddable html for a mapbox style. use when you want to embed a style in an iframe after verifying access.
Commit Event
Triggered when a new commit is pushed to a repository.
Retrieve Directions
Tool to retrieve directions between waypoints. use when you need navigation routes with optional turn-by-turn instructions after confirming origin and destination.
Connect any two apps with Notis in the middle.
Not just GitHub and Mapbox. Any combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7 days free trial with 20$ free usage included.
No card. Works with personal or business Mapbox.