{"id":28036378,"url":"https://github.com/pilinux/postmark","last_synced_at":"2025-05-11T12:55:32.747Z","repository":{"id":37981327,"uuid":"445391890","full_name":"pilinux/postmark","owner":"pilinux","description":"Real-time notifications from Postmark webhooks","archived":false,"fork":false,"pushed_at":"2023-03-07T02:51:10.000Z","size":183,"stargazers_count":1,"open_issues_count":7,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-11T12:54:35.989Z","etag":null,"topics":["go","golang","mit","mit-license","open-source","opensource","pilinux","postmark","postmark-webhooks","postmarkapp","webhook","webhooks"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pilinux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-01-07T03:59:05.000Z","updated_at":"2024-01-12T11:31:22.000Z","dependencies_parsed_at":"2024-01-12T02:14:12.397Z","dependency_job_id":null,"html_url":"https://github.com/pilinux/postmark","commit_stats":{"total_commits":9,"total_committers":3,"mean_commits":3.0,"dds":0.2222222222222222,"last_synced_commit":"32e21007c28226a8155f79dd94103c8cbaeb2f25"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilinux%2Fpostmark","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilinux%2Fpostmark/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilinux%2Fpostmark/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pilinux%2Fpostmark/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pilinux","download_url":"https://codeload.github.com/pilinux/postmark/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253568710,"owners_count":21928909,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","mit","mit-license","open-source","opensource","pilinux","postmark","postmark-webhooks","postmarkapp","webhook","webhooks"],"created_at":"2025-05-11T12:55:32.140Z","updated_at":"2025-05-11T12:55:32.734Z","avatar_url":"https://github.com/pilinux.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# postmark\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/pilinux/postmark)][01]\n[![CodeFactor](https://www.codefactor.io/repository/github/pilinux/postmark/badge)][02]\n[![codebeat badge](https://codebeat.co/badges/cd6b8c1c-c682-4535-9c15-e0c15124838d)][03]\n[![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg)][04]\n\n## Real-time notifications from [Postmark][11] [webhooks][12]\n\n\u0026#9889; Receive notifications via webhooks\n\n\u0026#9889; Save events in MySQL / PostgreSQL / SQLite\n\n### Best use-case\n\n\u0026#9889; Handle repeated abuses on the application-side before\nsending transactional emails to a fake/bad email address\n\n### Features\n\nVersion: `0.1.1`\n\n| Message type  | Supported          |\n| ------------- | ------------------ |\n| Transactional | :white_check_mark: |\n| Inbound       | :x:                |\n| Broadcasts    | :x:                |\n\n### Setup\n\n- You need a MySQL / PostgreSQL instance, or you can use SQLite\n- Download the binary `go install github.com/pilinux/postmark@latest`\n- Create a free project on [Sentry][13] to track errors\n  - Choose `Go` as the platform\n  - Save the `DNS` (format: `https://secret_code@abc.ingest.sentry.io/secret_number`)\n- Change the filename from `.env.sample` to `.env`\n- Update the following variables in the `.env` file (DO NOT DELETE other non-used variables)\n  - `APP_PORT`\n  - `SentryDSN`\n  - `USERNAME`\n  - `PASSWORD`\n  - `DBDRIVER`\n  - `DBUSER`\n  - `DBPASS`\n  - `DBNAME`\n  - `DBHOST`\n  - `DBPORT`\n  - `DBTIMEZONE`\n- Execute the binary file. It will automatically create a new table\n  `postmark_outbounds` and migrate the database.\n- On Postmark,\n  - select your server and browse the `transactional` message stream\n  - select `Add webhook`\n  - add the following information:\n    - Webhook URL: `http(s)://\u003cyour_ip_or_domain:port\u003e/webhooks/v1/outbound-events`\n      If you run the application behind a reverse proxy (NGINX / Apache) and configure a\n      domain, then the URL will be `http(s)://\u003cyour_domain\u003e/webhooks/v1/outbound-events`\n    - add `Basic auth credentials`\n    - select the events Postmark should forward to your server\n\n### `postmark_outbounds` database\n\n| Name          | Comment                                                               |\n| ------------- | --------------------------------------------------------------------- |\n| `id`          | primary key                                                           |\n| `created_at`  | data creation time in the database                                    |\n| `updated_at`  |                                                                       |\n| `deleted_at`  |                                                                       |\n| `record_type` | Delivery / Bounce / SpamComplaint / Open / Click / SubscriptionChange |\n| `type`        | HardBounce / SpamComplaint                                            |\n| `type_code`   | 1 (for bounce) / 100001 (for spam complaint) / 0 (others)             |\n| `message_id`  | Postmark message ID                                                   |\n| `tag`         | user-defined tag                                                      |\n| `from`        | from email                                                            |\n| `to`          | destination email                                                     |\n| `event_at`    | timestamp from Postmark                                               |\n| `server_id`   | Postmark server ID                                                    |\n\n## License\n\n\u0026#169; piLinux 2022\n\nReleased under the [MIT license][04]\n\nThis project is built with [GoREST][21].\n\n[01]: https://goreportcard.com/report/github.com/pilinux/postmark\n[02]: https://www.codefactor.io/repository/github/pilinux/postmark\n[03]: https://codebeat.co/projects/github-com-pilinux-postmark-main\n[04]: LICENSE\n[11]: https://postmarkapp.com\n[12]: https://postmarkapp.com/developer/webhooks/webhooks-overview\n[13]: https://sentry.io\n[21]: https://github.com/piLinux/GoREST\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpilinux%2Fpostmark","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpilinux%2Fpostmark","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpilinux%2Fpostmark/lists"}