List webhooks

Request

curl -X GET 'https://app.mailyte.com/api/v1/webhooks' \
  -H 'Authorization: Bearer mk_live_YOUR_API_KEY'

const response = await fetch('https://app.mailyte.com/api/v1/webhooks', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer mk_live_YOUR_API_KEY',
  },
});
const { data } = await response.json();

import requests
response = requests.get(
    "https://app.mailyte.com/api/v1/webhooks",
    headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
)
data = response.json()["data"]

<?php

$response = Http::withToken('mk_live_YOUR_API_KEY')
    ->get('https://app.mailyte.com/api/v1/webhooks');

$data = $response->json('data');

require "net/http"
require "json"
uri = URI("https://app.mailyte.com/api/v1/webhooks")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer mk_live_YOUR_API_KEY"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

Response

Success.

• dataarray<object>
  • objectstringwebhook
  • idstring

    Unique identifier for the webhook.

  • namestring

    Your name for the webhook.

  • urlstring

    Where we send events. It must be a public HTTPS address.

  • statusstringactive | inactive

    An inactive webhook is skipped by the dispatcher. It is not deleted and keeps its delivery history and its secret.

  • eventsarray<string>

    The events this webhook receives. A name not on this list is refused with a 422. quota.warning is an older name for storage.quota.warning and still works, but do not use it for new webhooks. contact.checked, checks.running_low and checks.ran_out are about your account, not one email, so filters never hold them back; they are sent only while Bounce protection is on.

  • targetingobject

    Which events reach this webhook. A field that is null does not narrow anything.

    • domainstring

      Only events for this domain, exact match (acme.com does not match notacme.com). Null means every domain. Always set on an email.inbound webhook in an account with more than one domain.

    • sender_includesarray<string>

      Any-of substring match on the sender. null = not narrowed.

    • subject_containsarray<string>

      Any-of substring match on the subject. null = not narrowed.

    • body_containsarray<string>

      Any-of substring match on the body. null = not narrowed.

  • deliveriesobject

    The delivery history, grouped so the numbers cannot disagree.

    • succeededinteger

      Lifetime tally of accepted deliveries.

    • failedinteger

      Lifetime tally of failed deliveries.

    • consecutive_failuresinteger

      Resets to zero on any success. This is what drives auto-disable, so it answers a different question from failed.

    • success_ratenumber

      The percentage of deliveries that succeeded, 0 to 100. Null when no delivery has been tried yet; show it as "no deliveries yet", not as 0.

  • last_delivered_atstring

    When a delivery to this webhook last succeeded, in ISO 8601 UTC. Null when none has succeeded yet; check deliveries to see whether any were tried.

  • created_atstring

    ISO 8601 UTC.

Returned inside the standard envelope.

Errors

Every status, with what causes it and what to do, is on the error reference.