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 Whether or not emails for the domain can only be sent over a TLS connection
skip_verification required	boolean Weather or not the certificate and hostname will be verified when trying to establish a TLS connection

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

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.
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.

Responses

200

A 200 response

Response Schema: application/json

message required	string Domain connection settings have been updated
require_tls required	boolean Whether or not emails for the domain can only be sent over a TLS connection
skip_verification required	boolean Weather or not the certificate and hostname will be verified when trying to establish a TLS connection

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"
}

Cookie Policy GDPR Email Compliance Acceptable Use Policy Terms of Service Privacy Policy

Domain Connection

Get connection's details

path Parameters

Response Schema: application/json

Update domain connection settings

path Parameters

Request Body schema: multipart/form-datarequired

Response Schema: application/json

Request Body schema: multipart/form-data
required