Skip to content
Mailgun Optimize/API Documentation/
/
Get Slack channel

Alerts (0.0.1)

Our alerting solution is centered around two concepts: events and channels. The occurrence of an event can be configured to trigger an alert. A channel describes the delivery method for an alert. Every configured alert consists of an event type / channel pair. This level of granularity allows alerting to be configured to your exact preference.

Download OpenAPI description
inboxready.json
inboxready.yaml
Languages
Servers
US Mailgun

https://api.mailgun.net/

EU Mailgun

https://api.eu.mailgun.net/

Domains

Operations

DMARC Reports

DMARC reporting provides valuable insights into your infrastructure, helping you identify potential issues like senders, misconfigured email servers, or phishing attempts.

Operations

Inbox Placement

Inbox Placement testing allows you to see the likely deliverability of your email campaigns.

Operations

Spam Traps Monitoring

Our spam trap monitoring service surfaces how much of your email is being sent to known spam traps.

Operations

Email Health Score

Operations

IP Blocklist Monitoring

Operations

Domain Blocklist Monitoring

Blocklist Monitoring enables you to keep an eye on your reputation. Monitor your domains against our curated list of blocklist providers to make sure you aren't being blocked.

Operations

Google Postmaster Tools

This API provides access to Google Postmaster data.

Operations

Microsoft SNDS

This API provides access to Microsoft SNDS data.

Operations

Alerts

Operations

Revoke Slack access token

Request

Revoke Slack access token, delete Slack settings and Slack event settings.

NOTE: All Mailgun accounts connected to the same Slack workspace share the same token.

To completely remove the Slack App from Slack Workspace, go into App Configuration in Slack.

Security
basicAuth
curl -i -X DELETE \
  -u <username>:<password> \
  https://api.mailgun.net/v1/alerts/slack/oauth

Responses

A 204 response

Response
No content

Get Slack channel

Request

Returns Slack channel.

Security
basicAuth
Path
idstringrequired

The Slack channel ID.

curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/alerts/slack/channels/{id}'

Responses

A 200 response

Bodyapplication/json
idstringrequired
namestringrequired
is_archivedbooleanrequired
Response
application/json
{
  "id": "C012AB3CD",
  "name": "general"
}

List Slack channels

Request

List Slack channels for the connected Slack workspace.

Security
basicAuth
Query
pagestring

Encoded paging information, provided via 'next', 'first' links

limitinteger

Limits the number of items returned in a request

curl -i -X GET \
  -u <username>:<password> \
  'https://api.mailgun.net/v1/alerts/slack/channels?page=string&limit=0'

Responses

A 200 response

Bodyapplication/json
itemsArray of objects(github.com-mailgun-alerts-internal-api-SlackChannel)required
items[].​idstringrequired
items[].​namestringrequired
items[].​is_archivedbooleanrequired
pagingobject(github.com-mailgun-scaffold-httpapi-paging-PagingResponse)required
paging.​previousstringrequired

Previous page URL

paging.​firststringrequired

First page URL

paging.​nextstringrequired

Next page URL

paging.​laststringrequired

Last page URL

Response
application/json
{
  "items": [
    { … }
  ],
  "paging": {
    "first": "https://api.mailgun.net/v1/alerts/slack/channels?page=foo",
    "next": "https://api.mailgun.net/v1/alerts/slack/channels?page=bar"
  }
}