Skip to content

Create Mailgun SMTP credentials for a given domain

Request

Create Mailgun SMTP credentials for a given domain

Security
basicAuth
Path
domain_namestringrequired

Hostname for new credentials

Bodymultipart/form-datarequired
loginstringrequired

Email address of SMTP credential user; accepts multiple values

mailboxstring

Email address of SMTP credential user, may be used in place of 'login'; accepts multiple values

systemboolean

Identify if these are system account credentials, defaults to false

passwordstring

Supply desired password(s) for the new credentials if preferred over generated ones; accepts multiple values

curl -i -X POST \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v3/domains/{domain_name}/credentials' \
  -H 'Content-Type: multipart/form-data' \
  -F login=string \
  -F mailbox=string \
  -F system=true \
  -F password=string

Responses

A 200 response

Bodyapplication/json
messagestringrequired

Response message

notestring

Note to store password (when generated by Mailgun)

credentialsobject

Credential username/password values (when generated by Mailgun)

Response
{ "message": "Created 1 credentials pair(s)" }