Domain Connection

A Domain Connection makes it easy for a user to configure DNS for a domain running at a DNS provider to work with a Service running at an independent Service Provider.

Get connection's details

get/v3/domains/{name}/connection

Returns domain's delivery connection settings.

SecuritybasicAuth
Request
path Parameters
name
required
string

The name of the domain you want to fetch

Responses
200

A 200 response

Response Schema: application/json
require_tls
required
boolean
skip_verification
required
boolean
401

A 401 response

404

A 404 response

Request samples
Response samples
application/json
{
  • "require_tls": true,
  • "skip_verification": true
}

Update domain connection settings

put/v3/domains/{name}/connection

Update a domain's TLS connection settings.

SecuritybasicAuth
Request
path Parameters
name
required
string

The name of the domain you want to update

Request Body schema: multipart/form-data
required
skip_verification
boolean

If set to true, the certificate and hostname will not be verified when tryingto establish a TLS connection and Mailgun will accept any certificate during delivery of a message.

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.

The default value is false.

require_tls
boolean

If set to true, this requires messages for the domain only be sent over a TLS connection. If a TLS connection cannot 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.

The default value is false.

Responses
200

A 200 response

Response Schema: application/json
message
required
string
require_tls
required
boolean
skip_verification
required
boolean
401

A 401 response

404

A 404 response

Request samples
Response samples
application/json
{
  • "message": "Domain connection settings have been updated, may take 10 minutes to fully propagate"
}