[github/fretlink/terraform-provider-mailgun.git] / docs / providers / mailgun / r / domain.html

<!DOCTYPE html>
<html lang="en">
  <head>
  <script type="text/javascript">
    WEB_SOCKET_SWF_LOCATION = "/__rack/WebSocketMain.swf";
    
  </script>
  <script type="text/javascript" src="../../../../__rack/swfobject.js"></script>
  <script type="text/javascript" src="../../../../__rack/web_socket.js"></script>

<script type="text/javascript">
  RACK_LIVERELOAD_PORT = 35729;
</script>
<script type="text/javascript" src="../../../../__rack/livereload.js%3Fhost=0.0.0.0&amp;port=35729"></script>


    <meta charset="utf-8">
    <meta name="mobile-web-app-capable" content="yes">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="The domain_resource allows mailgun domain to be managed by Terraform.">

    <link rel="apple-touch-icon" sizes="180x180" href="http://localhost:4567/assets/images/favicons/apple-touch-icon.png">
    <link rel="icon" type="image/png" href="http://localhost:4567/assets/images/favicons/favicon-32x32.png" sizes="32x32">
    <link rel="icon" type="image/png" href="http://localhost:4567/assets/images/favicons/favicon-16x16.png" sizes="16x16">
    <link rel="manifest" href="http://localhost:4567/android-manifest.json">
    <link rel="mask-icon" href="http://localhost:4567/assets/images/favicons/safari-pinned-tab.svg" color="#5C4EE5">
    <meta name="msapplication-config" content="/microsoft-tile.xml" />
    <meta name="theme-color" content="#ffffff">
    
      <meta name="twitter:card" content="summary" />
      <meta property="og:image" content="https://www.terraform.io/assets/images/og-image.png"/>
      <meta property="og:image:width" content="100"/>
      <meta property="og:image:height" content="100"/>
    <meta name="twitter:site" content="@HashiCorp" />
    <meta name="twitter:creator" content="@HashiCorp" />
    <meta property="og:type" content="website" />
    <meta property="og:url" content="https://www.terraform.io/docs/providers/mailgun/r/domain.html" />
    <meta property="og:title" content="Mailgun: mailgun_domain - Terraform by HashiCorp" />
    <meta property="og:site_name" content="Terraform by HashiCorp"/>
    <meta property="og:description" content="The domain_resource allows mailgun domain to be managed by Terraform." />

    <title>Mailgun: mailgun_domain - Terraform by HashiCorp</title>

    <!-- Stylesheets -->
    <link rel="stylesheet" href="https://use.typekit.net/wxf7mfi.css">
    <link href="../../../../assets/stylesheets/application.css" rel="stylesheet" />

    <!-- Site scripts -->
    <!--[if lt IE 9]><script src="/assets/javascripts/ie-compat.js" defer="defer"></script><![endif]-->
    <script src="../../../../assets/javascripts/application.js" defer="defer"></script>

    <!-- Analytics scrpts -->
    <script defer>
      !function(){var e=window.analytics=window.analytics||[];if(!e.initialize)if(e.invoked)window.console&&console.error&&console.error("Segment snippet included twice.");else{e.invoked=!0,e.methods=["trackSubmit","trackClick","trackLink","trackForm","pageview","identify","reset","group","track","ready","alias","debug","page","once","off","on"],e.factory=function(t){return function(){var a=Array.prototype.slice.call(arguments);return a.unshift(t),e.push(a),e}};for(var t=0;t<e.methods.length;t++){var a=e.methods[t];e[a]=e.factory(a)}e.load=function(e){var t=document.createElement("script");t.type="text/javascript",t.async=!0,t.src=("https:"===document.location.protocol?"https://":"http://")+"cdn.segment.com/analytics.js/v1/"+e+"/analytics.min.js";var a=document.getElementsByTagName("script")[0];a.parentNode.insertBefore(t,a)},e.SNIPPET_VERSION="4.0.0",e.load("0EXTgkNx0Ydje2PGXVbRhpKKoe5wtzcE")}}();var om597a24292a958,om597a24292a958_poll=function(){var e=0;return function(t,a){clearInterval(e),e=setInterval(t,a)}}();!function(e,t,a){if(e.getElementById(a))om597a24292a958_poll(function(){if(window.om_loaded&&!om597a24292a958)return(om597a24292a958=new OptinMonsterApp).init({s:"35109.597a24292a958",staging:0,dev:0,beta:0})},25);else{var n=!1,o=e.createElement("script");o.id=a,o.src="//a.optnmstr.com/app/js/api.min.js",o.async=!0,o.onload=o.onreadystatechange=function(){if(!(n||this.readyState&&"loaded"!==this.readyState&&"complete"!==this.readyState))try{n=om_loaded=!0,(om597a24292a958=new OptinMonsterApp).init({s:"35109.597a24292a958",staging:0,dev:0,beta:0}),o.onload=o.onreadystatechange=null}catch(e){}},(document.getElementsByTagName("head")[0]||document.documentElement).appendChild(o)}}(document,0,"omapi-script");
    </script>

    
  </head>

  <body id="page-docs-mailgun-domain" class="layout-mailgun page-mailgun-mailgun-domain">

    <svg class="hidden-print" aria-hidden="true" style="position: absolute; width: 0; height: 0;" width="0" height="0" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
  <defs>
    <symbol id="mega-nav-icon-angle" viewBox="0 0 13 7">
      <polygon points="6.5,6.5 0.7,1.6 1.3,0.8 6.5,5.2 11.7,0.8 12.3,1.6 "/>
    </symbol>
    <symbol id="mega-nav-icon-close" viewBox="0 0 13 15">
      <path vector-effect="non-scaling-stroke" d="M1.1 14L11.9 1M11.9 14L1.1 1"/>
    </symbol>
  </defs>
</svg>
<div class="hidden-print mega-nav-sandbox">
  <div class="mega-nav-banner">
    <div class="container">
      <div class="mega-nav-banner-item">
        <a class="mega-nav-banner-logo" href="https://www.hashicorp.com"><img src="../../../../assets/images/mega-nav/logo-hashicorp-wordmark.svg" alt="HashiCorp Logo" /></a>
      </div>
      <div class="mega-nav-banner-item">
        <p class="mega-nav-tagline"><span class="visible-xs text-muted">Learn the</span><span class="hidden-xs text-muted">Learn how Terraform fits into the</span></p>
        <div id="#mega-nav" class="mega-nav">
          <button type="button" id="mega-nav-ctrl" class="mega-nav-ctrl">
            <div class="mega-nav-ctrl-items">
              <img src="../../../../assets/images/mega-nav/logo-hashicorp.svg" alt="HashiCorp Logo" />
              <strong>HashiCorp Suite</strong>
              <span class="mega-nav-icon-outline">
                <svg class="mega-nav-icon mega-nav-icon-angle-right" aria-hidden="true"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#mega-nav-icon-angle"></use></svg><span class="visuallyhidden">Open</span>
              </span>
            </div>
          </button>
          <div id="mega-nav-body-ct" class="mega-nav-body-ct" aria-labelledby="mega-nav-ctrl">
            <div class="mega-nav-body">
              <button type="button" id="mega-nav-close" class="mega-nav-close"><svg class="mega-nav-icon mega-nav-icon-close" aria-hidden="true"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#mega-nav-icon-close"></use></svg><span class="visuallyhidden">Close</span></button>
              <div class="mega-nav-body-header">
                <div class="mega-nav-body-header-item">
                  <h2 class="mega-nav-h1">Provision, Secure, Connect, and&nbsp;Run</h2>
                  <p class="mega-nav-h2">Any infrastructure for any&nbsp;application</p>
                </div>
                <div class="mega-nav-body-header-item">
                  <a href="https://www.hashicorp.com/" class="mega-nav-btn"><img src="../../../../assets/images/mega-nav/logo-hashicorp.svg" alt="HashiCorp Logo" /> Learn the HashiCorp Enterprise&nbsp;Suite <svg class="mega-nav-icon mega-nav-icon-angle-right" aria-hidden="true"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="#mega-nav-icon-angle"></use></svg></a>
                </div>
              </div>
              <div class="mega-nav-body-grid">
                <div class="mega-nav-body-grid-item">
                  <h3 class="mega-nav-h3">Provision</h3>
                  <ul class="mega-nav-grid">
                    <li>
                      <a href="https://www.vagrantup.com" class="mega-nav-grid-item mega-nav-grid-item-vagrant">
                        <div class="mega-nav-grid-item-img">
                          <img src="../../../../assets/images/mega-nav/logo-vagrant.svg" alt="Vagrant Logo" />
                        </div>
                        <b>Vagrant</b>
                        <ul>
                          <li><span class="mega-nav-tag">Build</span></li>
                          <li><span class="mega-nav-tag">Test</span></li>
                        </ul>
                      </a>
                    </li>
                    <li>
                      <a href="https://www.packer.io" class="mega-nav-grid-item mega-nav-grid-item-packer">
                        <div class="mega-nav-grid-item-img">
                          <img src="../../../../assets/images/mega-nav/logo-packer.svg" alt="Packer Logo" />
                        </div>
                        <b>Packer</b>
                        <ul>
                          <li><span class="mega-nav-tag">Package</span></li>
                        </ul>
                      </a>
                    </li>
                    <li>
                      <a href="https://www.terraform.io" class="mega-nav-grid-item mega-nav-grid-item-terraform">
                        <div class="mega-nav-grid-item-img">
                          <img src="../../../../assets/images/mega-nav/logo-terraform.svg" alt="Terraform Logo" />
                        </div>
                        <b>Terraform</b>
                        <ul>
                          <li><span class="mega-nav-tag">Provision</span></li>
                        </ul>
                      </a>
                    </li>
                  </ul>
                </div>
                <div class="mega-nav-body-grid-item">
                  <h3 class="mega-nav-h3">Secure</h3>
                  <ul class="mega-nav-grid">
                    <li>
                      <a href="https://www.vaultproject.io" class="mega-nav-grid-item mega-nav-grid-item-vault">
                        <div class="mega-nav-grid-item-img">
                          <img src="../../../../assets/images/mega-nav/logo-vault.svg" alt="Vault Logo" />
                        </div>
                        <b>Vault</b>
                        <ul>
                          <li><span class="mega-nav-tag">Secure</span></li>
                        </ul>
                      </a>
                    </li>
                  </ul>
                </div>
                <div class="mega-nav-body-grid-item">
                  <h3 class="mega-nav-h3">Connect</h3>
                  <ul class="mega-nav-grid">
                    <li>
                      <a href="https://www.consul.io" class="mega-nav-grid-item mega-nav-grid-item-consul">
                        <div class="mega-nav-grid-item-img">
                          <img src="../../../../assets/images/mega-nav/logo-consul.svg" alt="Consul Logo" />
                        </div>
                        <b>Consul</b>
                        <ul>
                          <li><span class="mega-nav-tag">Connect</span></li>
                        </ul>
                      </a>
                    </li>
                  </ul>
                </div>
                <div class="mega-nav-body-grid-item">
                  <h3 class="mega-nav-h3">Run</h3>
                  <ul class="mega-nav-grid">
                    <li>
                      <a href="https://www.nomadproject.io" class="mega-nav-grid-item mega-nav-grid-item-nomad">
                        <div class="mega-nav-grid-item-img">
                          <img src="../../../../assets/images/mega-nav/logo-nomad.svg" alt="Nomad Logo" />
                        </div>
                        <b>Nomad</b>
                        <ul>
                          <li><span class="mega-nav-tag">Run</span></li>
                        </ul>
                      </a>
                    </li>
                  </ul>
                </div>
              </div>
              <div class="mega-nav-body-footer">
                <p>Seven elements of the modern Application Lifecycle</p>
              </div>
            </div>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>


    <div id="header" class="navigation navbar-static-top hidden-print">
      <div class="container">
        <div class="row">
          <div class="col-xs-12">
            <div class="navbar-header">
              <div class="navbar-brand">
                <a href="http://localhost:4567/">
                  <svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 251 61" class="logo" height="50">
  <path class="text" fill="#000" fill-rule="nonzero" d="M81.78 19.54h-8.89v-5.31H96.7v5.31h-8.9v26.53h-6"></path>
  <path class="text" fill="#000" fill-rule="nonzero" d="M102.19 41.77c2.415-.012 4.814-.383 7.12-1.1l.91 4.4c-2.745.99-5.642 1.49-8.56 1.48-7.31 0-9.85-3.39-9.85-9V31.4c0-4.92 2.2-9.08 9.66-9.08s9.13 4.35 9.13 9.37v5h-13v1.2c.05 2.78 1.05 3.88 4.59 3.88zM97.65 32h7.41v-1.18c0-2.2-.67-3.73-3.54-3.73s-3.87 1.53-3.87 3.73V32zm28.54-4.33c-2.148.97-4.217 2.102-6.19 3.39v15h-5.83V22.79h4.92l.38 2.58c1.897-1.284 3.955-2.313 6.12-3.06l.6 5.36zm14.24 0c-2.14.97-4.204 2.103-6.17 3.39v15h-5.83V22.79h4.92l.38 2.58c1.897-1.284 3.955-2.313 6.12-3.06l.58 5.36zm19.51 18.4h-4.78l-.43-1.58c-2.062 1.342-4.47 2.058-6.93 2.06-4.25 0-6.07-2.92-6.07-6.93 0-4.73 2.06-6.55 6.79-6.55h5.59v-2.44c0-2.58-.72-3.49-4.45-3.49-2.17.024-4.33.266-6.45.72l-.72-4.45c2.606-.72 5.296-1.09 8-1.1 7.31 0 9.47 2.58 9.47 8.41l-.02 15.35zm-5.83-8.8h-4.3c-1.91 0-2.44.53-2.44 2.29s.53 2.34 2.34 2.34c1.544-.024 3.058-.436 4.4-1.2v-3.43zm23.75-19.79c-1.1-.237-2.224-.364-3.35-.38-2.29 0-2.63 1-2.63 2.77v2.92h5.93l-.33 4.64h-5.59v18.64h-5.83V27.43h-3.73v-4.64h3.73v-3.25c0-4.83 2.25-7.22 7.41-7.22 1.69-.006 3.372.22 5 .67l-.61 4.49zm11.38 29.07c-8 0-10.13-4.4-10.13-9.18v-5.88c0-4.78 2.15-9.18 10.13-9.18s10.13 4.4 10.13 9.18v5.88c.01 4.78-2.15 9.18-10.13 9.18zm0-19.27c-3.11 0-4.3 1.39-4.3 4v6.26c0 2.63 1.2 4 4.3 4 3.1 0 4.3-1.39 4.3-4V31.3c0-2.63-1.19-4.02-4.3-4.02zm25.14.39c-2.14.97-4.204 2.103-6.17 3.39v15h-5.83V22.79h4.92l.38 2.58c1.897-1.284 3.954-2.313 6.12-3.06l.58 5.36zm16.02 18.4V29.82c0-1.24-.53-1.86-1.86-1.86-2.137.254-4.2.934-6.07 2v16.11h-5.83V22.79h4.45l.57 2c2.906-1.47 6.088-2.315 9.34-2.48 1.843-.174 3.6.82 4.4 2.49 2.91-1.49 6.104-2.34 9.37-2.49 3.87 0 5.26 2.72 5.26 6.88v16.88h-5.83V29.82c0-1.24-.53-1.86-1.86-1.86-2.14.236-4.208.917-6.07 2v16.11h-5.87z"></path>
  <path class="rect-dark" fill="#4040B2" d="M36.4 39.13l16.4-9.46V10.72L36.4 20.2"></path>
  <path class="rect-light" fill="#5C4EE5" d="M18.2 10.72l16.4 9.48v18.93l-16.4-9.47"></path>
  <path class="rect-light" fill="#5C4EE5" d="M0 19.09l16.4 9.47V9.62L0 .15m18.2 50.53l16.4 9.47V41.21l-16.4-9.47"></path>
</svg>

                </a>
              </div>
              <button class="navbar-toggle" type="button">
                <span class="sr-only">Toggle navigation</span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
              </button>
            </div>


            <div class="buttons hidden-xs">
              <nav class="navigation-links" role="navigation">
                <ul class="main-links nav navbar-nav navbar-right">
                  <li class="visible-sm"><span><a href="http://localhost:4567/index.html">Info</a><svg width="9" height="5" xmlns="http://www.w3.org/2000/svg"><path d="M8.811 1.067a.612.612 0 0 0 0-.884.655.655 0 0 0-.908 0L4.5 3.491 1.097.183a.655.655 0 0 0-.909 0 .615.615 0 0 0 0 .884l3.857 3.75a.655.655 0 0 0 .91 0l3.856-3.75z" fill-rule="evenodd"/></svg></span>
                    <ul class="dropdown">
                      <li><a href="http://localhost:4567/intro/index.html">Intro</a></li>
                      <li><a href="https://learn.hashicorp.com/terraform/">Learn</a></li>
                      <li><a href="http://localhost:4567/community.html">Community</a></li>
                      <li><a href="https://www.hashicorp.com/products/terraform/?utm_source=oss&utm_medium=header-nav&utm_campaign=terraform">Enterprise</a></li>
                    </ul>
                  </li>
                  <li class="hidden-sm"><a href="http://localhost:4567/intro/index.html">Intro</a></li>
                  <li class="hidden-sm"><a href="https://learn.hashicorp.com/terraform/">Learn</a></li>
                  <li><span><a href="http://localhost:4567/docs/index.html">Docs</a><svg width="9" height="5" xmlns="http://www.w3.org/2000/svg"><path d="M8.811 1.067a.612.612 0 0 0 0-.884.655.655 0 0 0-.908 0L4.5 3.491 1.097.183a.655.655 0 0 0-.909 0 .615.615 0 0 0 0 .884l3.857 3.75a.655.655 0 0 0 .91 0l3.856-3.75z" fill-rule="evenodd"/></svg></span>
                    <ul class="dropdown">
                                      <li><a href="http://localhost:4567/docs/index.html">Docs Home</a></li>
                <li><a href="http://localhost:4567/docs/cli-index.html">Terraform CLI</a></li>
                <li><a href="http://localhost:4567/docs/enterprise/index.html">Terraform Enterprise</a></li>
                <li><a href="http://localhost:4567/docs/providers/index.html">Providers</a></li>
                <li><a href="http://localhost:4567/docs/glossary.html">Glossary</a></li>
                <li><a href="http://localhost:4567/guides/index.html">Guides and Whitepapers</a></li>
                <li><a href="http://localhost:4567/docs/registry/index.html">Registry</a></li>
                <li><a href="http://localhost:4567/docs/github-actions/index.html">GitHub Actions</a></li>
                <li><a href="http://localhost:4567/docs/extend/index.html">Extending Terraform</a></li>

                    </ul>
                  </li>
                  <li class="hidden-sm"><a href="http://localhost:4567/community.html">Community</a></li>
                  <li class="hidden-sm"><a href="https://www.hashicorp.com/products/terraform/?utm_source=oss&utm_medium=header-nav&utm_campaign=terraform">Enterprise</a></li>
                  <li>
                    <a href="http://localhost:4567/downloads.html">
                      <svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewbox="0 0 28 28" enable-background="new 0 0 28 28" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
  <path d="M28 0H0v28h28V0zM13.8 22.9L7 17.3l2-2.4 3.2 2.6V7h3.2v10.5l3.2-2.6 2 2.4L13.8 22.9z"></path>
</svg>
 Download
                    </a>
                  </li>
                  <li>
                    <a href="https://github.com/hashicorp/terraform">
                      <svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewbox="0 0 28 28" enable-background="new 0 0 28 28" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
  <path d="M28 0H0v28h11.4c0 0 0-1.3 0-2.4C7.7 26.4 7 23.9 7 23.9 6.4 22.4 5.5 22 5.5 22c-1.2-0.8 0.1-0.8 0.1-0.8 1.3 0.1 2 1.4 2 1.4 1.2 2 3 1.4 3.8 1.1 0.1-0.8 0.5-1.4 0.9-1.8 -2.9-0.3-6-1.5-6-6.5 0-1.4 0.5-2.6 1.3-3.5C7.5 11.5 7 10.2 7.8 8.4c0 0 1.1-0.4 3.6 1.3 1-0.3 2.2-0.4 3.3-0.4 1.1 0 2.2 0.2 3.3 0.4 2.5-1.7 3.6-1.3 3.6-1.3 0.7 1.8 0.3 3.1 0.1 3.5 0.8 0.9 1.3 2.1 1.3 3.5 0 5-3.1 6.1-6 6.5 0.5 0.4 0.9 1.2 0.9 2.4 0 1.8 0 3.7 0 3.7H28V0z"></path>
</svg>
 GitHub
                    </a>
                  </li>
                </ul>
              </nav>
            </div>
          </div>
        </div>
      </div>
    </div>


    <div class="sidebar-overlay"></div>

<aside class="sidebar" role="navigation">
  <div class="sidebar-header">
    <svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 251 61" class="logo" height="42">
  <path class="text" fill="#000" fill-rule="nonzero" d="M81.78 19.54h-8.89v-5.31H96.7v5.31h-8.9v26.53h-6"></path>
  <path class="text" fill="#000" fill-rule="nonzero" d="M102.19 41.77c2.415-.012 4.814-.383 7.12-1.1l.91 4.4c-2.745.99-5.642 1.49-8.56 1.48-7.31 0-9.85-3.39-9.85-9V31.4c0-4.92 2.2-9.08 9.66-9.08s9.13 4.35 9.13 9.37v5h-13v1.2c.05 2.78 1.05 3.88 4.59 3.88zM97.65 32h7.41v-1.18c0-2.2-.67-3.73-3.54-3.73s-3.87 1.53-3.87 3.73V32zm28.54-4.33c-2.148.97-4.217 2.102-6.19 3.39v15h-5.83V22.79h4.92l.38 2.58c1.897-1.284 3.955-2.313 6.12-3.06l.6 5.36zm14.24 0c-2.14.97-4.204 2.103-6.17 3.39v15h-5.83V22.79h4.92l.38 2.58c1.897-1.284 3.955-2.313 6.12-3.06l.58 5.36zm19.51 18.4h-4.78l-.43-1.58c-2.062 1.342-4.47 2.058-6.93 2.06-4.25 0-6.07-2.92-6.07-6.93 0-4.73 2.06-6.55 6.79-6.55h5.59v-2.44c0-2.58-.72-3.49-4.45-3.49-2.17.024-4.33.266-6.45.72l-.72-4.45c2.606-.72 5.296-1.09 8-1.1 7.31 0 9.47 2.58 9.47 8.41l-.02 15.35zm-5.83-8.8h-4.3c-1.91 0-2.44.53-2.44 2.29s.53 2.34 2.34 2.34c1.544-.024 3.058-.436 4.4-1.2v-3.43zm23.75-19.79c-1.1-.237-2.224-.364-3.35-.38-2.29 0-2.63 1-2.63 2.77v2.92h5.93l-.33 4.64h-5.59v18.64h-5.83V27.43h-3.73v-4.64h3.73v-3.25c0-4.83 2.25-7.22 7.41-7.22 1.69-.006 3.372.22 5 .67l-.61 4.49zm11.38 29.07c-8 0-10.13-4.4-10.13-9.18v-5.88c0-4.78 2.15-9.18 10.13-9.18s10.13 4.4 10.13 9.18v5.88c.01 4.78-2.15 9.18-10.13 9.18zm0-19.27c-3.11 0-4.3 1.39-4.3 4v6.26c0 2.63 1.2 4 4.3 4 3.1 0 4.3-1.39 4.3-4V31.3c0-2.63-1.19-4.02-4.3-4.02zm25.14.39c-2.14.97-4.204 2.103-6.17 3.39v15h-5.83V22.79h4.92l.38 2.58c1.897-1.284 3.954-2.313 6.12-3.06l.58 5.36zm16.02 18.4V29.82c0-1.24-.53-1.86-1.86-1.86-2.137.254-4.2.934-6.07 2v16.11h-5.83V22.79h4.45l.57 2c2.906-1.47 6.088-2.315 9.34-2.48 1.843-.174 3.6.82 4.4 2.49 2.91-1.49 6.104-2.34 9.37-2.49 3.87 0 5.26 2.72 5.26 6.88v16.88h-5.83V29.82c0-1.24-.53-1.86-1.86-1.86-2.14.236-4.208.917-6.07 2v16.11h-5.87z"></path>
  <path class="rect-dark" fill="#4040B2" d="M36.4 39.13l16.4-9.46V10.72L36.4 20.2"></path>
  <path class="rect-light" fill="#5C4EE5" d="M18.2 10.72l16.4 9.48v18.93l-16.4-9.47"></path>
  <path class="rect-light" fill="#5C4EE5" d="M0 19.09l16.4 9.47V9.62L0 .15m18.2 50.53l16.4 9.47V41.21l-16.4-9.47"></path>
</svg>

  </div>

  <ul class="nav sidebar-nav">
    <li><a href="http://localhost:4567/intro/index.html">Intro</a></li>
    <li><a href="https://learn.hashicorp.com/terraform/">Learn</a></li>
    <li><a href="http://localhost:4567/community.html">Community</a></li>
    <li><a href="https://www.hashicorp.com/products/terraform/?utm_source=oss&utm_medium=header-nav&utm_campaign=terraform">Enterprise</a></li>
  </ul>

  <div class="divider"></div>

  <ul class="external nav sidebar-nav">
    <li>
      <a href="http://localhost:4567/downloads.html">
        <svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewbox="0 0 28 28" enable-background="new 0 0 28 28" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
  <path d="M28 0H0v28h28V0zM13.8 22.9L7 17.3l2-2.4 3.2 2.6V7h3.2v10.5l3.2-2.6 2 2.4L13.8 22.9z"></path>
</svg>
 Download
      </a>
    </li>
    <li>
      <a href="https://github.com/hashicorp/terraform">
        <svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewbox="0 0 28 28" enable-background="new 0 0 28 28" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
  <path d="M28 0H0v28h11.4c0 0 0-1.3 0-2.4C7.7 26.4 7 23.9 7 23.9 6.4 22.4 5.5 22 5.5 22c-1.2-0.8 0.1-0.8 0.1-0.8 1.3 0.1 2 1.4 2 1.4 1.2 2 3 1.4 3.8 1.1 0.1-0.8 0.5-1.4 0.9-1.8 -2.9-0.3-6-1.5-6-6.5 0-1.4 0.5-2.6 1.3-3.5C7.5 11.5 7 10.2 7.8 8.4c0 0 1.1-0.4 3.6 1.3 1-0.3 2.2-0.4 3.3-0.4 1.1 0 2.2 0.2 3.3 0.4 2.5-1.7 3.6-1.3 3.6-1.3 0.7 1.8 0.3 3.1 0.1 3.5 0.8 0.9 1.3 2.1 1.3 3.5 0 5-3.1 6.1-6 6.5 0.5 0.4 0.9 1.2 0.9 2.4 0 1.8 0 3.7 0 3.7H28V0z"></path>
</svg>
 GitHub
      </a>
    </li>
  </ul>

  <div class="divider"></div>

  <ul class="nav sidebar-nav">
    <li><a href="http://localhost:4567/docs/index.html">Docs:</a></li>
                    <li><a href="http://localhost:4567/docs/index.html">Docs Home</a></li>
                <li><a href="http://localhost:4567/docs/cli-index.html">Terraform CLI</a></li>
                <li><a href="http://localhost:4567/docs/enterprise/index.html">Terraform Enterprise</a></li>
                <li><a href="http://localhost:4567/docs/providers/index.html">Providers</a></li>
                <li><a href="http://localhost:4567/docs/glossary.html">Glossary</a></li>
                <li><a href="http://localhost:4567/guides/index.html">Guides and Whitepapers</a></li>
                <li><a href="http://localhost:4567/docs/registry/index.html">Registry</a></li>
                <li><a href="http://localhost:4567/docs/github-actions/index.html">GitHub Actions</a></li>
                <li><a href="http://localhost:4567/docs/extend/index.html">Extending Terraform</a></li>

  </ul>

</aside>


    <div class="container">
  <div class="row">
    <div id="docs-sidebar" class="col-sm-4 col-md-3 col-xs-12 hidden-print" role="complementary">
      <a href="domain.html#inner" id="screenreader-skip" class="sr-only sr-only-focusable">Skip to content</a>
      <a href="domain.html#inner" id="mobile-skip" class="visible-xs">(Skip to content ⤵︎)</a>
      <div id="controls-placeholder" style="display: none;"></div>
          <div class="docs-sidebar hidden-print affix-top" role="complementary">
      <ul class="nav docs-sidenav">
        <li>
          <a href="http://localhost:4567/docs/providers/index.html">All Providers</a>
        </li>

        <li>
          <a href="../index.html">Mailgun Provider</a>
        </li>

        <li>
          <a href="domain.html#">Resources</a>
          <ul class="nav nav-visible">
            <li>
              <a href="domain.html" class="current-page">mailgun_domain</a>
	    </li>
	     <li>
              <a href="route.html">mailgun_route</a>
	    </li>
          </ul>
        </li>
      </ul>
    </div>

    </div>

    <div id="inner" class="col-sm-8 col-md-9 col-xs-12" role="main">
      
  <h1 id="mailgun_domain">
  <a name="mailgun_domain" class="anchor" href="domain.html#mailgun_domain">&raquo;</a>
  mailgun_domain
</h1>
<p>The domain resource allows Mailgun domain to be managed by Terraform.</p>
<h2 id="example-usage">
  <a name="example-usage" class="anchor" href="domain.html#example-usage">&raquo;</a>
  Example Usage
</h2>
<div class="highlight"><pre class="highlight hcl"><code><span class="n">resource</span> <span class="s2">"mailgun_domain"</span> <span class="s2">"example"</span> <span class="p">{</span>
      <span class="nb">name</span><span class="o">=</span><span class="s2">"domain.com"</span>
      <span class="n">spam_action</span><span class="o">=</span><span class="s2">"block"</span>
      <span class="n">smtp_password</span><span class="o">=</span><span class="s2">"password"</span>
      <span class="n">wildcard</span><span class="o">=</span><span class="kp">true</span>
      <span class="n">force_dkim_authority</span><span class="o">=</span><span class="kp">true</span>
      <span class="n">dkim_key_size</span><span class="o">=</span><span class="mi">1024</span>
      <span class="n">ips</span><span class="o">=</span><span class="p">[</span><span class="s2">"192.161.0.1"</span><span class="p">,</span> <span class="s2">"192.168.0.2"</span><span class="p">]</span>
      <span class="n">credentials</span><span class="p">{</span>
           <span class="n">login</span><span class="o">=</span><span class="s2">"login"</span>
           <span class="n">password</span><span class="o">=</span><span class="s2">"password"</span>
      <span class="p">}</span>
      <span class="n">open_tracking_settings_active</span><span class="o">=</span><span class="kp">true</span>
      <span class="n">click_tracking_settings_active</span><span class="o">=</span><span class="kp">true</span>
      <span class="n">unsubscribe_tracking_settings_active</span><span class="o">=</span><span class="kp">true</span>
      <span class="n">unsubscribe_tracking_settings_html_footer</span><span class="o">=</span><span class="s2">"&lt;p&gt;footer&lt;/p&gt;"</span>
      <span class="n">unsubscribe_tracking_settings_text_footer</span><span class="o">=</span><span class="s2">"footer"</span>
      <span class="n">require_tls</span><span class="o">=</span><span class="kp">true</span>
      <span class="n">skip_verification</span><span class="o">=</span><span class="kp">true</span>
<span class="p">}</span>
</code></pre></div><h2 id="argument-reference">
  <a name="argument-reference" class="anchor" href="domain.html#argument-reference">&raquo;</a>
  Argument Reference
</h2>
<p>The following arguments are supported:</p>

<ul>
<li><a name="name" /><a href="domain.html#name"><code>name</code></a> - (Required) Name of the domain
</li>
<li><a name="spam_action" /><a href="domain.html#spam_action"><code>spam_action</code></a> - (Optional) &quot;disabled&quot;, &quot;block&quot;, or &quot;tag&quot;.If &quot;disabled&quot;, no spam filtering will occur for inbound messages.If &quot;block&quot;, inbound spam messages will not be delivered.If &quot;tag&quot;, inbound messages will be tagged with a spam header. See Spam Filter.Defaults to disabled.
</li>
<li><a name="smtp_password" /><a href="domain.html#smtp_password"><code>smtp_password</code></a> - (Optional) Password for SMTP authentication
</li>
<li><a name="wildcard" /><a href="domain.html#wildcard"><code>wildcard</code></a> - (Optional) Determines whether the domain will accept email for sub-domains when sending messages.Defaults to false.
</li>
<li><a name="force_dkim_authority" /><a href="domain.html#force_dkim_authority"><code>force_dkim_authority</code></a> - (Optional) If set to true, the domain will be the DKIM authority for itself even if the root domain is registered on the same mailgun account.If set to false, the domain will have the same DKIM authority as the root domain registered on the same mailgun account. Defaults to false
</li>
<li><a name="dkim_key_size" /><a href="domain.html#dkim_key_size"><code>dkim_key_size</code></a> - (Optional) 1024 or 2048. Set the length of your domain’s generated DKIM key. Defaults to 1024.
</li>
<li><a name="ips" /><a href="domain.html#ips"><code>ips</code></a> - (Optional) An optional, comma-separated list of IP addresses to be assigned to this domain. If not specified, all dedicated IP addresses on the account will be assigned. If the request cannot be fulfilled (e.g. a requested IP is not assigned to the account, etc), a 400 will be returned.
</li>
<li><a name="credentials" /><a href="domain.html#credentials"><code>credentials</code></a> - (Optional) SMTP credentials for the domain
</li>
<li><a name="open_tracking_settings_active" /><a href="domain.html#open_tracking_settings_active"><code>open_tracking_settings_active</code></a> - (Optional) true to enable open tracking. Defauls to false
</li>
<li><a name="click_tracking_settings_active" /><a href="domain.html#click_tracking_settings_active"><code>click_tracking_settings_active</code></a> - (Optional) true to enable click tracking. Defauls to false
</li>
<li><a name="unsubscribe_tracking_settings_active" /><a href="domain.html#unsubscribe_tracking_settings_active"><code>unsubscribe_tracking_settings_active</code></a> - (Optional) true to enable unsubscribe tracking. Defauls to false
</li>
<li><a name="unsubscribe_tracking_settings_html_footer" /><a href="domain.html#unsubscribe_tracking_settings_html_footer"><code>unsubscribe_tracking_settings_html_footer</code></a> - (Optional)Custom HTML version of unsubscribe footer.Defaults to &quot;\n<br>\n<p><a hre=\"%unsubscribe_url%\">unsubscribe</a></p>\n&quot;
</li>
<li><a name="unsubscribe_tracking_settings_text_footer" /><a href="domain.html#unsubscribe_tracking_settings_text_footer"><code>unsubscribe_tracking_settings_text_footer</code></a> - (Optional) Custom text version of unsubscribe footer. Defaults to &quot;\n\nTo unsubscribe click: &lt;%unsubscribe_url%&gt;\n\n&quot;
</li>
<li><a name="require_tls" /><a href="domain.html#require_tls"><code>require_tls</code></a> - (Optional) If set to true, this requires the message only be sent over a TLS connection. If a TLS connection can not be established, Mailgun will not deliver the message.If set to false, Mailgun will still try and upgrade the connection, but if Mailgun cannot, the message will be delivered over a plaintext SMTP connection. Defaults to false.
</li>
<li><a name="skip_verification" /><a href="domain.html#skip_verification"><code>skip_verification</code></a> - (Optional)If set to true, the certificate and hostname will not be verified when trying to establish a TLS connection and Mailgun will accept any certificate during delivery. If set to false, Mailgun will verify the certificate and hostname. If either one can not be verified, a TLS connection will not be established. Defaults to false.
The <code>credentials</code>  object supports the following:
</li>
<li><a name="login" /><a href="domain.html#login"><code>login</code></a> - (Required) The user name
</li>
<li><a name="password" /><a href="domain.html#password"><code>password</code></a> - (Required) A password for the SMTP credentials. (Length Min 5, Max 32)
</li>
</ul>
<h2 id="attributes-reference">
  <a name="attributes-reference" class="anchor" href="domain.html#attributes-reference">&raquo;</a>
  Attributes Reference
</h2>
<p>The following attribute is exported:</p>

<ul>
<li><a name="smtp_login" /><a href="domain.html#smtp_login"><code>smtp_login</code></a> - An username for the SMTP credentials.
</li>
<li><a name="created_at" /><a href="domain.html#created_at"><code>created_at</code></a> - The date of creation of the domain.
</li>
<li><a name="state" /><a href="domain.html#state"><code>state</code></a> - The state of the domain.
</li>
<li><a name="receiving_records" /><a href="domain.html#receiving_records"><code>receiving_records</code></a> - DNS records for receiving.
</li>
<li><a name="sending_records" /><a href="domain.html#sending_records"><code>sending_records</code></a> - DNS records for sending.
The <code>receiving_records</code> <code>sending_records</code> and object exports the following:
</li>
<li><a name="name-1" /><a href="domain.html#name-1"><code>name</code></a> - The name of the record.
</li>
<li><a name="priority" /><a href="domain.html#priority"><code>priority</code></a> - The priority of the record lower value means a more important priority.
</li>
<li><a name="record_type" /><a href="domain.html#record_type"><code>record_type</code></a> - The type of record.
</li>
<li><a name="valid" /><a href="domain.html#valid"><code>valid</code></a> - Wether the record is valid or not.
</li>
<li><a name="value" /><a href="domain.html#value"><code>value</code></a> - The value of the record.
</li>
</ul>
<h2 id="import">
  <a name="import" class="anchor" href="domain.html#import">&raquo;</a>
  Import
</h2>
<p>Mailgun domain can be imported using the domain name, e.g.</p>
<div class="highlight"><pre class="highlight plaintext"><code>tf import mailgun_domain.example domain.com

</code></pre></div>

    </div>
  </div>
</div>


    <div id="footer" class="navigation hidden-print">
      <div class="container">
        <div class="row">
          <div class="col-xs-12">
            <ul class="footer-links nav navbar-nav">
              <li><a href="http://localhost:4567/intro/index.html">Intro</a></li>
              <li><a href="http://localhost:4567/docs/index.html">Docs</a></li>
              <li><a href="http://localhost:4567/docs/extend/index.html">Extend</a></li>
              <li><a href="https://www.hashicorp.com/privacy">Privacy</a></li>
              <li><a href="http://localhost:4567/security.html">Security</a></li>
              <li><a href="http://localhost:4567/assets/files/press-kit.zip">Press Kit</a></li>
            </ul>
            <ul class="footer-links nav navbar-nav navbar-right">
              <li><a href="https://github.com/terraform-providers/terraform-provider-mailgun/edit/master/website/docs/r/domain.html.markdown">Edit this page</a></li>
            </ul>
          </div>
        </div>
      </div>
    </div>

    <script type="application/ld+json">
      {
        "@context": "http://schema.org",
        "@type": "Product",
        "name": "Terraform",
        "alternateName": "Terraform by HashiCorp",
        "manufacturer": "HashiCorp",
        "url": "https://www.terraform.io",
        "logo": "https://www.terraform.io/assets/images/logo-hashicorp.svg",
        "sameAs": [
          "https://github.com/hashicorp/terraform"
        ]
      }
    </script>
  </body>
</html>