Documentation

Webhooks

When Mailcast receives an email, it can send a request to a webhook endpoint you specify.

The email can be parsed and sent in structured formats, or as a raw email message.

Formats supported

Webhooks can be called with any standard HTTP method: HEAD, GET, POST, PUT, and PATCH, but not DELETE.
But, because of HTML semantics, HEAD and GET only support the urlencoded format.

URL processing

The URL can contain parts of the email address.

  • {local_part} is replaced with everything before the @ symbol.
  • {user} is replaced with the user part of the email address (everything before the + symbol, if it is present).
  • {tag} is replaced with everything after the + symbol, if it is present.

Examples

https://example.com/{user}/{tag}

john+facebook@example.com → https://example.com/john/facebook