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

{"skip_verification": true,
"require_tls": 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"
}

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