Mailgun supports the creation, modification, and deletion of subaccounts. A subaccount is a child account of a parent account. The parent account can have multiple subaccounts. The subaccounts are created and managed by the parent account.
Create a subaccount
post/v5/accounts/subaccounts
Create a subaccount
SecuritybasicAuth
Responses
200
Successfully created a subaccount
400
Error response
Request samples
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
Response samples
- 200
- 400
application/json
{- "subaccount": {
- "id": "123",
- "name": "My subaccount",
- "status": "open"
}
}Disable a subaccount
post/v5/accounts/subaccounts/{subaccount_id}/disable
Disable a subaccount
SecuritybasicAuth
Request
Responses
200
Subaccount disabled successfully
400
Subaccount is already disabled
404
Not found
Request samples
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
Response samples
- 200
- 400
- 404
application/json
{- "subaccount": {
- "id": "123",
- "name": "My subaccount",
- "status": "disabled"
}
}Enable a subaccount
post/v5/accounts/subaccounts/{subaccount_id}/enable
Enable a subaccount
SecuritybasicAuth
Responses
200
Subaccount enabled successfully
400
Cannot enable due to limit reached
404
Not found
Request samples
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
Response samples
- 200
- 400
- 404
application/json
{- "subaccount": {
- "id": "123",
- "name": "My subaccount",
- "status": "open"
}
}Update subaccount feature
put/v5/accounts/subaccounts/{subaccount_id}/features
Update subaccount feature
SecuritybasicAuth
Request
Request samples
- Payload
- curl
- Go
- Node.js
- PHP
- Java
- Python
- C#
- Ruby
application/x-www-form-urlencoded
Response samples
- 200
- 400
- 404
application/json
{- "features": {
- "validations": {
- "enabled": true
}
}
}