Integrations / Infrastructure

Heroku

Look up apps, releases, builds and dynos, restart dynos, and trigger workflows from Heroku app webhook events.

9 tools 10 trigger events

Tools

heroku.get_app

Get an app by name or UUID, e.g. my-app.

app*

heroku.list_releases

List an app's 20 latest releases, newest first, from the first page of up to 200 that Heroku returns. Release versions are numbers, e.g. 42.

app*

heroku.get_release

Get one of an app's releases by version number, e.g. 42, or UUID.

app*release*

heroku.list_builds

List an app's 20 latest builds, newest first, from the first page of up to 200 that Heroku returns. Build IDs are UUIDs.

app*

heroku.list_dynos

List an app's running dynos and their states.

app*

heroku.restart_dyno writes

Restart one of an app's dynos by name, e.g. web.1, or UUID.

app*dyno*

heroku.create_app_webhook writes

Subscribe a URL to an app's webhook events, signed with a secret you choose.

app*url*include*secret*level

heroku.api_get

Send a GET request to any Heroku API path under https://api.heroku.com and return the response. For endpoints the named tools don't cover.

path*params

heroku.api_request writes

Send a POST, PUT, PATCH or DELETE request to any Heroku API path under https://api.heroku.com.

method*path*paramsbody

Tick Allow raw writes on the connection to add api_request, which can send POST, PUT, PATCH and DELETE requests to any Heroku API path.

Connect

  1. Create a non-expiring API token with heroku authorizations:create -d "Murmurator" in the Heroku CLI.
  2. Paste the token on the connection.
  3. To trigger workflows, pick a long random secret, subscribe the app with the create_app_webhook tool or heroku webhooks:add -s <secret> in the CLI, using the request URL shown on the connection page, and paste the same secret on the connection.

Credentials

API token Webhook secret

Heroku API docs

Triggers

Subscribe the app to this URL with the create_app_webhook tool, or heroku webhooks:add -i api:release,api:build -l sync -u <this URL> -s <secret> -a <app>, and paste the same secret on this connection.

Events

api:releaseapi:buildapi:dynoapi:formationapi:addonapi:addon-attachmentapi:appapi:collaboratorapi:domainapi:sni-endpoint
 trigger
kind: heroku
connection: heroku
events: [api:release]
actions: [...]
apps: [...]
statuses: [...]

Your next automation is one sentence away.

14-day free trial with $5 of built-in AI included. Cancel anytime.

Start free trial Talk to us