Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Mailgun Provider
  3. API Docs
  4. Domain
Mailgun v3.5.9 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-mailgun

mailgun.Domain

Explore with Pulumi AI

mailgun logo
Mailgun v3.5.9 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-mailgun

    Provides a Mailgun App resource. This can be used to create and manage applications on Mailgun.

    After DNS records are set, domain verification should be triggered manually using PUT /domains/<domain>/verify

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as mailgun from "@pulumi/mailgun";

// Create a new Mailgun domain
const _default = new mailgun.Domain("default", {
    name: "test.example.com",
    region: "us",
    spamAction: "disabled",
    smtpPassword: "supersecretpassword1234",
    dkimKeySize: 1024,
});

    import pulumi
import pulumi_mailgun as mailgun

# Create a new Mailgun domain
default = mailgun.Domain("default",
    name="test.example.com",
    region="us",
    spam_action="disabled",
    smtp_password="supersecretpassword1234",
    dkim_key_size=1024)

    package main

import (
	"github.com/pulumi/pulumi-mailgun/sdk/v3/go/mailgun"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Create a new Mailgun domain
		_, err := mailgun.NewDomain(ctx, "default", &mailgun.DomainArgs{
			Name:         pulumi.String("test.example.com"),
			Region:       pulumi.String("us"),
			SpamAction:   pulumi.String("disabled"),
			SmtpPassword: pulumi.String("supersecretpassword1234"),
			DkimKeySize:  pulumi.Int(1024),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mailgun = Pulumi.Mailgun;

return await Deployment.RunAsync(() => 
{
    // Create a new Mailgun domain
    var @default = new Mailgun.Domain("default", new()
    {
        Name = "test.example.com",
        Region = "us",
        SpamAction = "disabled",
        SmtpPassword = "supersecretpassword1234",
        DkimKeySize = 1024,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mailgun.Domain;
import com.pulumi.mailgun.DomainArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        // Create a new Mailgun domain
        var default_ = new Domain("default", DomainArgs.builder()
            .name("test.example.com")
            .region("us")
            .spamAction("disabled")
            .smtpPassword("supersecretpassword1234")
            .dkimKeySize(1024)
            .build());

    }
}

    resources:
  # Create a new Mailgun domain
  default:
    type: mailgun:Domain
    properties:
      name: test.example.com
      region: us
      spamAction: disabled
      smtpPassword: supersecretpassword1234
      dkimKeySize: 1024

    Create Domain Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Domain(name: string, args?: DomainArgs, opts?: CustomResourceOptions);
    @overload
def Domain(resource_name: str,
           args: Optional[DomainArgs] = None,
           opts: Optional[ResourceOptions] = None)

@overload
def Domain(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           click_tracking: Optional[bool] = None,
           dkim_key_size: Optional[int] = None,
           dkim_selector: Optional[str] = None,
           force_dkim_authority: Optional[bool] = None,
           name: Optional[str] = None,
           open_tracking: Optional[bool] = None,
           region: Optional[str] = None,
           smtp_password: Optional[str] = None,
           spam_action: Optional[str] = None,
           web_scheme: Optional[str] = None,
           wildcard: Optional[bool] = None)
    func NewDomain(ctx *Context, name string, args *DomainArgs, opts ...ResourceOption) (*Domain, error)
    public Domain(string name, DomainArgs? args = null, CustomResourceOptions? opts = null)
    public Domain(String name, DomainArgs args)
public Domain(String name, DomainArgs args, CustomResourceOptions options)

    type: mailgun:Domain
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DomainArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var domainResource = new Mailgun.Domain("domainResource", new()
{
    ClickTracking = false,
    DkimKeySize = 0,
    DkimSelector = "string",
    ForceDkimAuthority = false,
    Name = "string",
    OpenTracking = false,
    Region = "string",
    SmtpPassword = "string",
    SpamAction = "string",
    WebScheme = "string",
    Wildcard = false,
});

    example, err := mailgun.NewDomain(ctx, "domainResource", &mailgun.DomainArgs{
	ClickTracking:      pulumi.Bool(false),
	DkimKeySize:        pulumi.Int(0),
	DkimSelector:       pulumi.String("string"),
	ForceDkimAuthority: pulumi.Bool(false),
	Name:               pulumi.String("string"),
	OpenTracking:       pulumi.Bool(false),
	Region:             pulumi.String("string"),
	SmtpPassword:       pulumi.String("string"),
	SpamAction:         pulumi.String("string"),
	WebScheme:          pulumi.String("string"),
	Wildcard:           pulumi.Bool(false),
})

    var domainResource = new Domain("domainResource", DomainArgs.builder()
    .clickTracking(false)
    .dkimKeySize(0)
    .dkimSelector("string")
    .forceDkimAuthority(false)
    .name("string")
    .openTracking(false)
    .region("string")
    .smtpPassword("string")
    .spamAction("string")
    .webScheme("string")
    .wildcard(false)
    .build());

    domain_resource = mailgun.Domain("domainResource",
    click_tracking=False,
    dkim_key_size=0,
    dkim_selector="string",
    force_dkim_authority=False,
    name="string",
    open_tracking=False,
    region="string",
    smtp_password="string",
    spam_action="string",
    web_scheme="string",
    wildcard=False)

    const domainResource = new mailgun.Domain("domainResource", {
    clickTracking: false,
    dkimKeySize: 0,
    dkimSelector: "string",
    forceDkimAuthority: false,
    name: "string",
    openTracking: false,
    region: "string",
    smtpPassword: "string",
    spamAction: "string",
    webScheme: "string",
    wildcard: false,
});

    type: mailgun:Domain
properties:
    clickTracking: false
    dkimKeySize: 0
    dkimSelector: string
    forceDkimAuthority: false
    name: string
    openTracking: false
    region: string
    smtpPassword: string
    spamAction: string
    webScheme: string
    wildcard: false

    Domain Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Domain resource accepts the following input properties:

    ClickTracking bool
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    DkimKeySize int
    The length of your domain’s generated DKIM key. Default value is 1024.
    DkimSelector string
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    ForceDkimAuthority bool
    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. The default is false.
    Name string
    The domain to add to Mailgun
    OpenTracking bool
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    Region string
    The region where domain will be created. Default value is us.
    SmtpPassword string
    Password for SMTP authentication
    SpamAction string
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    WebScheme string
    (http or https) The tracking web scheme. Default: http
    Wildcard bool
    Boolean that determines whether the domain will accept email for sub-domains.
    ClickTracking bool
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    DkimKeySize int
    The length of your domain’s generated DKIM key. Default value is 1024.
    DkimSelector string
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    ForceDkimAuthority bool
    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. The default is false.
    Name string
    The domain to add to Mailgun
    OpenTracking bool
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    Region string
    The region where domain will be created. Default value is us.
    SmtpPassword string
    Password for SMTP authentication
    SpamAction string
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    WebScheme string
    (http or https) The tracking web scheme. Default: http
    Wildcard bool
    Boolean that determines whether the domain will accept email for sub-domains.
    clickTracking Boolean
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    dkimKeySize Integer
    The length of your domain’s generated DKIM key. Default value is 1024.
    dkimSelector String
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    forceDkimAuthority Boolean
    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. The default is false.
    name String
    The domain to add to Mailgun
    openTracking Boolean
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    region String
    The region where domain will be created. Default value is us.
    smtpPassword String
    Password for SMTP authentication
    spamAction String
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    webScheme String
    (http or https) The tracking web scheme. Default: http
    wildcard Boolean
    Boolean that determines whether the domain will accept email for sub-domains.
    clickTracking boolean
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    dkimKeySize number
    The length of your domain’s generated DKIM key. Default value is 1024.
    dkimSelector string
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    forceDkimAuthority boolean
    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. The default is false.
    name string
    The domain to add to Mailgun
    openTracking boolean
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    region string
    The region where domain will be created. Default value is us.
    smtpPassword string
    Password for SMTP authentication
    spamAction string
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    webScheme string
    (http or https) The tracking web scheme. Default: http
    wildcard boolean
    Boolean that determines whether the domain will accept email for sub-domains.
    click_tracking bool
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    dkim_key_size int
    The length of your domain’s generated DKIM key. Default value is 1024.
    dkim_selector str
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    force_dkim_authority bool
    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. The default is false.
    name str
    The domain to add to Mailgun
    open_tracking bool
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    region str
    The region where domain will be created. Default value is us.
    smtp_password str
    Password for SMTP authentication
    spam_action str
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    web_scheme str
    (http or https) The tracking web scheme. Default: http
    wildcard bool
    Boolean that determines whether the domain will accept email for sub-domains.
    clickTracking Boolean
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    dkimKeySize Number
    The length of your domain’s generated DKIM key. Default value is 1024.
    dkimSelector String
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    forceDkimAuthority Boolean
    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. The default is false.
    name String
    The domain to add to Mailgun
    openTracking Boolean
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    region String
    The region where domain will be created. Default value is us.
    smtpPassword String
    Password for SMTP authentication
    spamAction String
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    webScheme String
    (http or https) The tracking web scheme. Default: http
    wildcard Boolean
    Boolean that determines whether the domain will accept email for sub-domains.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Domain resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    ReceivingRecords List<DomainReceivingRecord>
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    ReceivingRecordsSets List<DomainReceivingRecordsSet>
    A set of DNS records for receiving validation.
    SendingRecords List<DomainSendingRecord>
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    SendingRecordsSets List<DomainSendingRecordsSet>
    A set of DNS records for sending validation.
    SmtpLogin string
    The login email for the SMTP server.
    Id string
    The provider-assigned unique ID for this managed resource.
    ReceivingRecords []DomainReceivingRecord
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    ReceivingRecordsSets []DomainReceivingRecordsSet
    A set of DNS records for receiving validation.
    SendingRecords []DomainSendingRecord
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    SendingRecordsSets []DomainSendingRecordsSet
    A set of DNS records for sending validation.
    SmtpLogin string
    The login email for the SMTP server.
    id String
    The provider-assigned unique ID for this managed resource.
    receivingRecords List<DomainReceivingRecord>
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    receivingRecordsSets List<DomainReceivingRecordsSet>
    A set of DNS records for receiving validation.
    sendingRecords List<DomainSendingRecord>
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    sendingRecordsSets List<DomainSendingRecordsSet>
    A set of DNS records for sending validation.
    smtpLogin String
    The login email for the SMTP server.
    id string
    The provider-assigned unique ID for this managed resource.
    receivingRecords DomainReceivingRecord[]
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    receivingRecordsSets DomainReceivingRecordsSet[]
    A set of DNS records for receiving validation.
    sendingRecords DomainSendingRecord[]
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    sendingRecordsSets DomainSendingRecordsSet[]
    A set of DNS records for sending validation.
    smtpLogin string
    The login email for the SMTP server.
    id str
    The provider-assigned unique ID for this managed resource.
    receiving_records Sequence[DomainReceivingRecord]
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    receiving_records_sets Sequence[DomainReceivingRecordsSet]
    A set of DNS records for receiving validation.
    sending_records Sequence[DomainSendingRecord]
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    sending_records_sets Sequence[DomainSendingRecordsSet]
    A set of DNS records for sending validation.
    smtp_login str
    The login email for the SMTP server.
    id String
    The provider-assigned unique ID for this managed resource.
    receivingRecords List<Property Map>
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    receivingRecordsSets List<Property Map>
    A set of DNS records for receiving validation.
    sendingRecords List<Property Map>
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    sendingRecordsSets List<Property Map>
    A set of DNS records for sending validation.
    smtpLogin String
    The login email for the SMTP server.

    Look up Existing Domain Resource

    Get an existing Domain resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: DomainState, opts?: CustomResourceOptions): Domain
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        click_tracking: Optional[bool] = None,
        dkim_key_size: Optional[int] = None,
        dkim_selector: Optional[str] = None,
        force_dkim_authority: Optional[bool] = None,
        name: Optional[str] = None,
        open_tracking: Optional[bool] = None,
        receiving_records: Optional[Sequence[DomainReceivingRecordArgs]] = None,
        receiving_records_sets: Optional[Sequence[DomainReceivingRecordsSetArgs]] = None,
        region: Optional[str] = None,
        sending_records: Optional[Sequence[DomainSendingRecordArgs]] = None,
        sending_records_sets: Optional[Sequence[DomainSendingRecordsSetArgs]] = None,
        smtp_login: Optional[str] = None,
        smtp_password: Optional[str] = None,
        spam_action: Optional[str] = None,
        web_scheme: Optional[str] = None,
        wildcard: Optional[bool] = None) -> Domain
    func GetDomain(ctx *Context, name string, id IDInput, state *DomainState, opts ...ResourceOption) (*Domain, error)
    public static Domain Get(string name, Input<string> id, DomainState? state, CustomResourceOptions? opts = null)
    public static Domain get(String name, Output<String> id, DomainState state, CustomResourceOptions options)
    resources:  _:    type: mailgun:Domain    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    ClickTracking bool
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    DkimKeySize int
    The length of your domain’s generated DKIM key. Default value is 1024.
    DkimSelector string
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    ForceDkimAuthority bool
    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. The default is false.
    Name string
    The domain to add to Mailgun
    OpenTracking bool
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    ReceivingRecords List<DomainReceivingRecord>
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    ReceivingRecordsSets List<DomainReceivingRecordsSet>
    A set of DNS records for receiving validation.
    Region string
    The region where domain will be created. Default value is us.
    SendingRecords List<DomainSendingRecord>
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    SendingRecordsSets List<DomainSendingRecordsSet>
    A set of DNS records for sending validation.
    SmtpLogin string
    The login email for the SMTP server.
    SmtpPassword string
    Password for SMTP authentication
    SpamAction string
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    WebScheme string
    (http or https) The tracking web scheme. Default: http
    Wildcard bool
    Boolean that determines whether the domain will accept email for sub-domains.
    ClickTracking bool
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    DkimKeySize int
    The length of your domain’s generated DKIM key. Default value is 1024.
    DkimSelector string
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    ForceDkimAuthority bool
    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. The default is false.
    Name string
    The domain to add to Mailgun
    OpenTracking bool
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    ReceivingRecords []DomainReceivingRecordArgs
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    ReceivingRecordsSets []DomainReceivingRecordsSetArgs
    A set of DNS records for receiving validation.
    Region string
    The region where domain will be created. Default value is us.
    SendingRecords []DomainSendingRecordArgs
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    SendingRecordsSets []DomainSendingRecordsSetArgs
    A set of DNS records for sending validation.
    SmtpLogin string
    The login email for the SMTP server.
    SmtpPassword string
    Password for SMTP authentication
    SpamAction string
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    WebScheme string
    (http or https) The tracking web scheme. Default: http
    Wildcard bool
    Boolean that determines whether the domain will accept email for sub-domains.
    clickTracking Boolean
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    dkimKeySize Integer
    The length of your domain’s generated DKIM key. Default value is 1024.
    dkimSelector String
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    forceDkimAuthority Boolean
    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. The default is false.
    name String
    The domain to add to Mailgun
    openTracking Boolean
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    receivingRecords List<DomainReceivingRecord>
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    receivingRecordsSets List<DomainReceivingRecordsSet>
    A set of DNS records for receiving validation.
    region String
    The region where domain will be created. Default value is us.
    sendingRecords List<DomainSendingRecord>
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    sendingRecordsSets List<DomainSendingRecordsSet>
    A set of DNS records for sending validation.
    smtpLogin String
    The login email for the SMTP server.
    smtpPassword String
    Password for SMTP authentication
    spamAction String
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    webScheme String
    (http or https) The tracking web scheme. Default: http
    wildcard Boolean
    Boolean that determines whether the domain will accept email for sub-domains.
    clickTracking boolean
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    dkimKeySize number
    The length of your domain’s generated DKIM key. Default value is 1024.
    dkimSelector string
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    forceDkimAuthority boolean
    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. The default is false.
    name string
    The domain to add to Mailgun
    openTracking boolean
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    receivingRecords DomainReceivingRecord[]
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    receivingRecordsSets DomainReceivingRecordsSet[]
    A set of DNS records for receiving validation.
    region string
    The region where domain will be created. Default value is us.
    sendingRecords DomainSendingRecord[]
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    sendingRecordsSets DomainSendingRecordsSet[]
    A set of DNS records for sending validation.
    smtpLogin string
    The login email for the SMTP server.
    smtpPassword string
    Password for SMTP authentication
    spamAction string
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    webScheme string
    (http or https) The tracking web scheme. Default: http
    wildcard boolean
    Boolean that determines whether the domain will accept email for sub-domains.
    click_tracking bool
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    dkim_key_size int
    The length of your domain’s generated DKIM key. Default value is 1024.
    dkim_selector str
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    force_dkim_authority bool
    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. The default is false.
    name str
    The domain to add to Mailgun
    open_tracking bool
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    receiving_records Sequence[DomainReceivingRecordArgs]
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    receiving_records_sets Sequence[DomainReceivingRecordsSetArgs]
    A set of DNS records for receiving validation.
    region str
    The region where domain will be created. Default value is us.
    sending_records Sequence[DomainSendingRecordArgs]
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    sending_records_sets Sequence[DomainSendingRecordsSetArgs]
    A set of DNS records for sending validation.
    smtp_login str
    The login email for the SMTP server.
    smtp_password str
    Password for SMTP authentication
    spam_action str
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    web_scheme str
    (http or https) The tracking web scheme. Default: http
    wildcard bool
    Boolean that determines whether the domain will accept email for sub-domains.
    clickTracking Boolean
    (Enum: yes or no) The click tracking settings for the domain. Default: no
    dkimKeySize Number
    The length of your domain’s generated DKIM key. Default value is 1024.
    dkimSelector String
    The name of your DKIM selector if you want to specify it whereas MailGun will make it's own choice.
    forceDkimAuthority Boolean
    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. The default is false.
    name String
    The domain to add to Mailgun
    openTracking Boolean
    (Enum: yes or no) The open tracking settings for the domain. Default: no
    receivingRecords List<Property Map>
    A list of DNS records for receiving validation. Deprecated Use receiving_records_set instead.

    Deprecated: Use receiving_records_set instead.

    receivingRecordsSets List<Property Map>
    A set of DNS records for receiving validation.
    region String
    The region where domain will be created. Default value is us.
    sendingRecords List<Property Map>
    A list of DNS records for sending validation. Deprecated Use sending_records_set instead.

    Deprecated: Use sending_records_set instead.

    sendingRecordsSets List<Property Map>
    A set of DNS records for sending validation.
    smtpLogin String
    The login email for the SMTP server.
    smtpPassword String
    Password for SMTP authentication
    spamAction String
    disabled or tag Disable, no spam filtering will occur for inbound messages. Tag, messages will be tagged with a spam header. Default value is disabled.
    webScheme String
    (http or https) The tracking web scheme. Default: http
    wildcard Boolean
    Boolean that determines whether the domain will accept email for sub-domains.

    Supporting Types

    DomainReceivingRecord, DomainReceivingRecordArgs

    Id string
    Priority string
    The priority of the record.
    RecordType string
    The record type.
    Valid string
    "valid" if the record is valid.
    Value string
    The value of the record.
    Id string
    Priority string
    The priority of the record.
    RecordType string
    The record type.
    Valid string
    "valid" if the record is valid.
    Value string
    The value of the record.
    id String
    priority String
    The priority of the record.
    recordType String
    The record type.
    valid String
    "valid" if the record is valid.
    value String
    The value of the record.
    id string
    priority string
    The priority of the record.
    recordType string
    The record type.
    valid string
    "valid" if the record is valid.
    value string
    The value of the record.
    id str
    priority str
    The priority of the record.
    record_type str
    The record type.
    valid str
    "valid" if the record is valid.
    value str
    The value of the record.
    id String
    priority String
    The priority of the record.
    recordType String
    The record type.
    valid String
    "valid" if the record is valid.
    value String
    The value of the record.

    DomainReceivingRecordsSet, DomainReceivingRecordsSetArgs

    Id string
    Priority string
    The priority of the record.
    RecordType string
    The record type.
    Valid string
    "valid" if the record is valid.
    Value string
    The value of the record.
    Id string
    Priority string
    The priority of the record.
    RecordType string
    The record type.
    Valid string
    "valid" if the record is valid.
    Value string
    The value of the record.
    id String
    priority String
    The priority of the record.
    recordType String
    The record type.
    valid String
    "valid" if the record is valid.
    value String
    The value of the record.
    id string
    priority string
    The priority of the record.
    recordType string
    The record type.
    valid string
    "valid" if the record is valid.
    value string
    The value of the record.
    id str
    priority str
    The priority of the record.
    record_type str
    The record type.
    valid str
    "valid" if the record is valid.
    value str
    The value of the record.
    id String
    priority String
    The priority of the record.
    recordType String
    The record type.
    valid String
    "valid" if the record is valid.
    value String
    The value of the record.

    DomainSendingRecord, DomainSendingRecordArgs

    Id string
    Name string
    The domain to add to Mailgun
    RecordType string
    The record type.
    Valid string
    "valid" if the record is valid.
    Value string
    The value of the record.
    Id string
    Name string
    The domain to add to Mailgun
    RecordType string
    The record type.
    Valid string
    "valid" if the record is valid.
    Value string
    The value of the record.
    id String
    name String
    The domain to add to Mailgun
    recordType String
    The record type.
    valid String
    "valid" if the record is valid.
    value String
    The value of the record.
    id string
    name string
    The domain to add to Mailgun
    recordType string
    The record type.
    valid string
    "valid" if the record is valid.
    value string
    The value of the record.
    id str
    name str
    The domain to add to Mailgun
    record_type str
    The record type.
    valid str
    "valid" if the record is valid.
    value str
    The value of the record.
    id String
    name String
    The domain to add to Mailgun
    recordType String
    The record type.
    valid String
    "valid" if the record is valid.
    value String
    The value of the record.

    DomainSendingRecordsSet, DomainSendingRecordsSetArgs

    Id string
    Name string
    The domain to add to Mailgun
    RecordType string
    The record type.
    Valid string
    "valid" if the record is valid.
    Value string
    The value of the record.
    Id string
    Name string
    The domain to add to Mailgun
    RecordType string
    The record type.
    Valid string
    "valid" if the record is valid.
    Value string
    The value of the record.
    id String
    name String
    The domain to add to Mailgun
    recordType String
    The record type.
    valid String
    "valid" if the record is valid.
    value String
    The value of the record.
    id string
    name string
    The domain to add to Mailgun
    recordType string
    The record type.
    valid string
    "valid" if the record is valid.
    value string
    The value of the record.
    id str
    name str
    The domain to add to Mailgun
    record_type str
    The record type.
    valid str
    "valid" if the record is valid.
    value str
    The value of the record.
    id String
    name String
    The domain to add to Mailgun
    recordType String
    The record type.
    valid String
    "valid" if the record is valid.
    value String
    The value of the record.

    Import

    Domains can be imported using region:domain_name via import command. Region has to be chosen from eu or us (when no selection us is applied).

    hcl

    $ pulumi import mailgun:index/domain:Domain test us:example.domain.com

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Mailgun pulumi/pulumi-mailgun
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the mailgun Terraform Provider.
    mailgun logo
    Mailgun v3.5.9 published on Wednesday, Apr 9, 2025 by Pulumi
    pulumi/pulumi-mailgun