{"id":15567788,"url":"https://github.com/circa10a/terraform-provider-mailform","last_synced_at":"2025-10-18T17:42:55.380Z","repository":{"id":65332003,"uuid":"558144654","full_name":"circa10a/terraform-provider-mailform","owner":"circa10a","description":"A terraform provider to send physical mail via https://mailform.io","archived":false,"fork":false,"pushed_at":"2023-02-28T01:53:57.000Z","size":4870,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-10T22:43:25.470Z","etag":null,"topics":["go","golang","mail","mailer","mailer-service","terraform","terraform-provider"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"nwheeler-splunk/terraform-provider-mailform","license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/circa10a.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-27T01:19:30.000Z","updated_at":"2023-08-16T11:46:44.000Z","dependencies_parsed_at":"2024-06-19T14:34:02.373Z","dependency_job_id":"cfd4a425-5ca6-44c9-82a1-cb0fba4e6999","html_url":"https://github.com/circa10a/terraform-provider-mailform","commit_stats":{"total_commits":155,"total_committers":24,"mean_commits":6.458333333333333,"dds":0.6387096774193548,"last_synced_commit":"05ce21e8d3a4e821fd45ec637b4d29bc9800ba51"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circa10a%2Fterraform-provider-mailform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circa10a%2Fterraform-provider-mailform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circa10a%2Fterraform-provider-mailform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circa10a%2Fterraform-provider-mailform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/circa10a","download_url":"https://codeload.github.com/circa10a/terraform-provider-mailform/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235048998,"owners_count":18927715,"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","mail","mailer","mailer-service","terraform","terraform-provider"],"created_at":"2024-10-02T17:13:09.449Z","updated_at":"2025-10-02T23:34:33.888Z","avatar_url":"https://github.com/circa10a.png","language":"Go","funding_links":["https://www.buymeacoffee.com/caleblemoine"],"categories":[],"sub_categories":[],"readme":"# terraform-provider-mailform \u003cimg src=\"https://i.imgur.com/fAS7XqO.png\" width=\"5%\" align=\"left\"/\u003e\n\nThis provider enables you to send physical mail, driven by terraform, via https://mailform.io\n\nStanding on the shoulders of giants enables us to yeet mail further.\n\n![Build Status](https://github.com/circa10a/terraform-provider-mailform/workflows/release/badge.svg)\n[![Go Report Card](https://goreportcard.com/badge/github.com/circa10a/terraform-provider-mailform)](https://goreportcard.com/report/github.com/circa10a/terraform-provider-mailform)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/circa10a/terraform-provider-mailform?style=plastic)\n[![Buy Me A Coffee](https://img.shields.io/badge/BuyMeACoffee-Donate-ff813f.svg?logo=CoffeeScript\u0026style=plastic)](https://www.buymeacoffee.com/caleblemoine)\n\n\u003e :warning: Orders cannot be updated/deleted (cancelled). Once created,no more modifications can be made due to API limitations. Deleted resources are simply removed from state.\n\n## Usage\n\nThe provider with use the environment variable `MAILFORM_API_TOKEN` by default unless specified in the provider configuration.\n\n```hcl\nterraform {\n  required_providers {\n    mailform = {\n      source = \"circa10a/mailform\"\n    }\n  }\n}\n\nprovider \"mailform\" {\n  api_token = \"XXX\" // If not specified, will read MAILFORM_API_TOKEN environment variable\n}\n\n// Create PDF\nresource \"mailform_pdf\" \"example\" {\n  header   = \"My Resumes\"\n  content  = \"Some resume contents\"\n  filename = \"./test.pdf\"\n}\n\n// Convert image to pdf for postcards\nresource \"mailform_pdf\" \"example\" {\n  image_filename = \"./test_image.jpg\"\n  filename       = \"./test_image.pdf\"\n}\n\n// Create mail order\nresource \"mailform_order\" \"example\" {\n  pdf_file       = mailform_pdf.example.filename\n  service        = \"USPS_PRIORITY\"\n  to_name        = \"A name\"\n  to_address_1   = \"Address 1\"\n  to_city        = \"Seattle\"\n  to_state       = \"WA\"\n  to_postcode    = \"00000\"\n  to_country     = \"US\"\n  from_name      = \"My name\"\n  from_address_1 = \"My Address 1\"\n  from_city      = \"Dallas\"\n  from_state     = \"TX\"\n  from_postcode  = \"00000\"\n  from_country   = \"US\"\n}\n\n// Fetch order data\ndata \"mailform_order\" \"example\" {\n  id = mailform_order.example.id\n}\n\noutput \"order_info\" {\n  value = data.mailform_order.example\n}\n```\n\n## Requirements\n\n- [Terraform](https://www.terraform.io/downloads.html) \u003e= 0.12.x\n- [Go](https://golang.org/doc/install) \u003e= 1.18\n\n## Building The Provider\n\n1. Clone the repository\n1. Enter the repository directory\n1. Build the provider using the Go `install` command:\n\n```sh\ngo install\n```\n\n## Adding Dependencies\n\nThis provider uses [Go modules](https://github.com/golang/go/wiki/Modules).\nPlease see the Go documentation for the most up to date information about using Go modules.\n\nTo add a new dependency `github.com/author/dependency` to your Terraform provider:\n\n```sh\ngo get github.com/author/dependency\ngo mod tidy\n```\n\nThen commit the changes to `go.mod` and `go.sum`.\n\n## Using the provider\n\nFill this in for each provider\n\n## Developing the Provider\n\nIf you wish to work on the provider, you'll first need [Go](http://www.golang.org) installed on your machine (see [Requirements](#requirements) above).\n\nTo compile the provider, run `go install`. This will build the provider and put the provider binary in the `$GOPATH/bin` directory.\n\nTo generate or update documentation, run `go generate`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcirca10a%2Fterraform-provider-mailform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcirca10a%2Fterraform-provider-mailform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcirca10a%2Fterraform-provider-mailform/lists"}