What's Changed

• preserve previous exception when rethrowing by @SunMar in #957
• • Mailgun::webhooks() no longer requires an explicit $signingKey … by @oleksandr-mykhailenko in #958

New Contributors

• @SunMar made their first contribution in #957

Full Changelog: v4.5.0...v4.5.1

Fixed

• Mailgun::webhooks() no longer requires an explicit $signingKey argument. When omitted, it falls back to the API key stored on the Mailgun instance, restoring compatibility with pre-v4.3.7 usage patterns (issue #947).

v4.5.1 Latest

Latest

Compare

Choose a tag to compare

What's Changed

• Added updated list of dimensions by @oleksandr-mykhailenko in #952
• Dynamic Ip Pools by @oleksandr-mykhailenko in #953
• Ip classes imporvements by @oleksandr-mykhailenko in #954
• version update by @oleksandr-mykhailenko in #955

Full Changelog: v4.4.0...v4.5.0

Added

• Completed IP Pools (DIPP) API coverage — all 11 remaining endpoints now implemented in Mailgun\Api\Ip:
  • listIpPools() — GET /v3/ip_pools
  • createIpPool(name, description) — POST /v3/ip_pools
  • updateIpPool(poolId, data) — PATCH /v3/ip_pools/{pool_id} (add/remove IPs, rename, link/unlink domains)
  • getIpPoolDomains(poolId, limit, page) — GET /v3/ip_pools/{pool_id}/domains
  • addIpToPool(poolId, ip) — PUT /v3/ip_pools/{pool_id}/ips/{ip}
  • removeIpFromPool(poolId, ip) — DELETE /v3/ip_pools/{pool_id}/ips/{ip}
  • addIpsToPool(poolId, ips[]) — POST /v3/ip_pools/{pool_id}/ips.json
  • delegateIpPool(poolId, subaccountId) — PUT /v3/ip_pools/{pool_id}/delegate
  • revokeDelegatedIpPool(poolId, subaccountId) — DELETE /v3/ip_pools/{pool_id}/delegate
  • assignIpToAllDomains(ip) — POST /v3/ips/{ip}/domains
  • removeIpFromAllDomains(ip, alternative) — DELETE /v3/ips/{ip}/domains
  • listIpsDetailed(params) — GET /v3/ips/details/all
• Added 5 new response model classes:
  • Mailgun\Model\Ip\IpPoolsResponse — pool list with pool_id, name, description, ips[], is_inherited, is_linked
  • Mailgun\Model\Ip\IpPoolResponse — single pool details (replaces incorrect UpdateResponse usage)
  • Mailgun\Model\Ip\IpPoolDomainsResponse — paginated domain list with nextPage cursor
  • Mailgun\Model\Ip\IpReferenceResponse — async-operation responses carrying message + reference_id
  • Mailgun\Model\Ip\IpDetailsResponse — detailed IP list for /v3/ips/details/all
• Added 31 tests covering all Ip API methods, including request URI/body assertions and response model property checks

Fixed

• loadDIPPInformation() was hydrating into UpdateResponse (message-only); now correctly returns IpPoolResponse
• deleteDIPP() replacement parameters ($ip, $repPoolId) were wrongly required; both are now optional (?string = null)
• deleteDIPP() URL was built via unsafe string concatenation; replaced with proper http_build_query construction
• addNewDIPPIntoAccount() used unsafe direct array key access ($data['description']); replaced with null-coalescing guard
• placeAccountIpToBand() had a redundant Assert::stringNotEmpty() call alongside Assert::ip() on the same value

Changed

• addNewDIPPIntoAccount() marked @deprecated in favour of the explicit createIpPool(string $name, string $description) method

v4.5.0

Compare

Choose a tag to compare

What's Changed

• Backward compatible fixes for previous release. by @oleksandr-mykhailenko in #951

Full Changelog: v4.3.7...v4.4.0

v4.4.0

Compare

Choose a tag to compare

What's Changed

• Temp fix for CI by @oleksandr-mykhailenko in #942
• Prepare release by @oleksandr-mykhailenko in #945
• Use subaccount model in create API response by @svenluijten in #934
• Update HttpApi.php by @omar-angelino in #940
• Add missing query parameters to Domain::index() methods by @Akrilla in #939
• Prepare release by @oleksandr-mykhailenko in #946
• Use webhook signing key instead of API key for webhook signature verification by @damiantw in #819
• Move dependabot config by @svenluijten in #936
• Update README.md by @jezemery in #937

New Contributors

• @omar-angelino made their first contribution in #940
• @Akrilla made their first contribution in #939
• @damiantw made their first contribution in #819
• @jezemery made their first contribution in #937

Full Changelog: v4.3.6...v4.3.7

v4.3.7

Compare

Choose a tag to compare

What's Changed

• Use ubuntu-latest for all CI runs by @svenluijten in #935
• docs: fix broken documentation URLs by @mshcherb in #941
• fix Mailgun API key placeholder by @mshcherb in #943

New Contributors

• @svenluijten made their first contribution in #935
• @mshcherb made their first contribution in #941

Full Changelog: v4.3.5...v4.3.6

v4.3.6

Compare

Choose a tag to compare

What's Changed

• api secure tracking endpoint by @oleksandr-mykhailenko in #932

• 4.3.5 by @oleksandr-mykhailenko in #933

Full Changelog: v4.3.4...v4.3.5

• Implemented AccountManagement API endpoints:
  • updateAccountSettings for PUT /v5/accounts
  • getHttpSigningKey for GET /v5/accounts/http_signing_key
  • createHttpSigningKey for POST /v5/accounts/http_signing_key
  • getSandboxAuthRecipients for GET /v5/sandbox/auth_recipients
• Added model classes for AccountManagement API responses:
  • AccountResponse
  • HttpSigningKeyResponse
  • SandboxAuthRecipientsResponse
• Updated Mailgun class to include AccountManagement API.

v4.3.5

Compare

Choose a tag to compare

What's Changed

• Add useAutomaticSenderSecurity support in DomainV4 by @matteotrubini in #928
• Remove extra validation by @oleksandr-mykhailenko in #929
• Domain Keys API Endpoints by @oleksandr-mykhailenko in #930
• De 1507 mailgun php increase max tag limit to 10 per message by @oleksandr-mykhailenko in #931

New Contributors

• @matteotrubini made their first contribution in #928

Full Changelog: v4.3.3...v4.3.4

• Extended limit of tags to 10.

v4.3.4

Compare

Choose a tag to compare

What's Changed

• Fixed way of sending request with JSON body. loadMetrics works. Adjus… by @oleksandr-mykhailenko in #927
• Fixed PHP 8.4 deprecations by @toooni in #926

New Contributors

• @toooni made their first contribution in #926

Full Changelog: v4.3.2...v4.3.3

• Fixed way of sending request with JSON body. loadMetrics works. Adjusted tests. Fixed warning related to the php 8.4 and nullable types

v4.3.3

Compare

Choose a tag to compare

What's Changed

• Added new API endpoint for getting metrics by @oleksandr-mykhailenko in #923

Full Changelog: v4.3.1...v4.3.2

• Added new API endpoint for getting metrics @see https://documentation.mailgun.com/docs/mailgun/api-reference/openapi-final/tag/Metrics/

v4.3.2

Compare

Choose a tag to compare

What's Changed

• Add method for retrieving stored messages by @oleksandr-mykhailenko in #920
• Add missed params to the create method for DomainV4.php by @oleksandr-mykhailenko in #921

Full Changelog: v4.3.0...v4.3.1

• Add method for retrieving stored messages by @oleksandr-mykhailenko in #920
• Add missed params to the create method for DomainV4.php by @oleksandr-mykhailenko in #921

v4.3.1

Compare

Choose a tag to compare

• End of support php 7.3
• Updated properties and added types to the classes properties
• Update code style
• Add missed field into IndexResponse for Webhooks
• Fixed template search filters
• Fixed tags API endpoints
• Added new API endpoints

• Added basic templates functionality

• Fix wrong classes in tests
• Fixed response in case of 404 http error. Respect server error message

• Bugfix: TypeError caused by improper use of new self() instead of new static() in base class method

• update library
• Improvement: SDK version headers v2 vs v3
• Update packages by @oleksandr-mykhailenko

• Fixed: bug when params to and reply-to have the same address

• Changed: support bool value for method createMultiple

Fixed

• Cast integer values to string for sending multipart data

Added

• Added ability to make own API request to needed endpoint

Added

• Ability to update web_scheme for domain
• http or https - set your open, click and unsubscribe URLs to use http or https. The default is http

Fixed

• Error with empty array for param recipient-variables. Fix was suggested by @deviarte
• Use null coalescing operator in IndexResponse.php when. Fix proposed by @TWithers

Added

• Support for new webhook endpoints (#609 by @svenbw & #749 by @Nyholm)

Fixed

• Fix double urlencoding (#747 by @uavn)

Added

• Email Validation (#726 by @uavn)
  • Please note the Email Validation requires always to use the US servers. The Mailgun Team didn't enable this service on the European endpoints.

Added

• Support for PHP 8 (#727 by @DavidGarciaCat)
• Added opened, clicked, unsubscribed and stored to the TotalResponseItem (#739 by @Arkitecht)

Removed

• Support for PHP 7.1 and 7.2 as they both have reached their end of life

Added

• Domain tracking implementation (#711 by @uavn)
• Mailing list validation (#712 by @uavn)
• Suppression Whitelists (#713 by @uavn)

Fixed

• Added pagination to tags (#717 by @uavn)

Changed

• Expect Client to be of type ClientInterface or PluginClient (#660 by @tonythomas01)

Added

• Suppressions allow now deleting an address passing an optional tag (#643 by @iwahara)
• Allow both ^1.0 and ^2.0 for php-http/guzzle6-adapter (#680 by @boboldehampsink)
• Add support for Mailing List reply_preference parameter (#684 by @twoonesixdigital)
• Add support for Force DKIM Authority when creating a Domain (#686 by @Tiboonn)
• Add support for PHP 7.4 (#698 by @snapshotpl)
• Allow assigning a domain to a list of ips during creation (#703 by @josephshanak)
• Add unmapped log-level property for Events (#704 by @uavn)

Fixed

• Provide the Member's name just when it's not null (#639 by @indapublic)
• Fix typehint for Message ShowResponse::getContentIdMap() (#664 by @lvdhoorn)
• Fix endpoint for Domain's API (#668 by @tomschlick)
• Webhook support for array handling (#675 by @martin-sanjuan)
• Fix parameter name when assigning an IP to the specified Domain (#702 by @josephshanak)
• Ip::index() now returns all IPs instead of the shared IPs (#707 by @josephshanak)

Changed

• Updated examples for Debugging and Hydrator usage (#634 by @tonybolzan and #681 by @Jiia)
• Updated link to the Mailgun Documentation page (#688 by @Casmo)
• Remove deprecated Laravel package due to it is archived (#695 by @tomschlick)

Removed

• Remove method for non-existing Stats URL (#705 by @uavn)

Added

• Support for PSR-4
• All classes Mailgun\Model are final or abstract.

Changed

• Dropped PHP5 support
• Removed deprecated code
• Moved RequestBuilder and HttpClientConfigurator to Mailgun\HttpClient namespace
• Updated signature of Mailgun::__construct()

Removed

• Dependency on php-http/message.

Fixed

• Added missing method to use all Mailing List and Ip features.

Added

• Add support for IPs endpoints
• Add spport for Mailing Lists
• Add complaints to Stats / Total Response
• Add more tests for our models

Changed

• Change the PHP Exception message for Bad Request errors to help to find the issue

Fixed

• Fix an issue validating the max path length

Added

• Allow to set the Mailgun server when instantiating the Mailgun's client: $mailgun = Mailgun::create('key', 'server');
• Add new PHPUnit tests for our models
• Add new PHPUnit tests for our API
• Added Mailgun\Api\Attachment
• Fluent interface for MessageBuilder and BatchMessage
• Support for HTTPlug 2.0

Changed

• Second argument to Mailgun\Message\MessageBuilder::addBccRecipient() is now optional.
• We try to close open resources

Fixed

• Fixed the type error when creating tags.

Added

• Ported MessageBuilder and BatchMessage #472

Changed

• Cast campaign IDs to string #460
• Suggest packages used on Dev #440

Added

• Support for 413 HTTP status codes, when we send too large payloads to the API

Added

• Add new Suppressions::getTotalCount() method

Changed

• Apply fixes from StyleCI
• Updated README.md file

Fixed

• Fix Tags on Unsubscribe
• Fix typo on Mailgun\Exception\HttpServerException

Added

• Add cached property for DNS record
• Add domain verification
• HttpClientException::getResponseCode()
• Added AbstractDomainResponse that VerifyResponse and CreateResponse extends.

Fixed

• Possible empty content of WebhookIndexResponse.
• Typo in TotalResponse that caused the content to be empty.

Changed

• Allow some parameters to Domain::create to be optional.

Fixed

• Typo in DnsRecord::isValid. This make sure the correct result of the function is returned.

Changed

• Using stable version of php-http/multipart-stream-builder
• Improved tests

Fixed

• When parsing an address in MessageBuilder we surround the recipient name with double quotes instead of single quotes.

Fixed

• Make sure to reset the MultipartStreamBuilder after a stream is built.

Added

• Support for sending messages with Mime. $mailgun->messages()->sendMime()

This version contains a new way of using the API. Each endpoint return a domain object and the endpoints are grouped like the API documentation.

Added

• Api classes in Mailgun\Api*
• Api models/responses in Mailgun\Model*
• Added Hydrators to hydrate PSR-7 responses to arrays or domain objects.
• All exceptions extend Mailgun\Exception.
• New exceptions in Mailgun\Exception namespace.
• Added HttpClientConfigurator to configure the HTTP client.
• Added HttpClient plugins History and ReplaceUriPlugin
• Assertions with Webmozart\Assert
• Mailgun\Mailgun::getLastResponse()
• Mailgun\Connection\RestClient::getAttachment($url)
• Clear license information

Fixed

• Fix disordered POST parameters. We do not use array syntax.
• Code styles

Deprecated

The following classes will be removed in version 3.0.

• Mailgun\Connection\Exceptions\GenericHTTPError
• Mailgun\Connection\Exceptions\InvalidCredentials
• Mailgun\Connection\Exceptions\MissingEndpoint
• Mailgun\Connection\Exceptions\MissingRequiredParameters
• Mailgun\Connection\Exceptions\NoDomainsConfigured
• Mailgun\Connection\RestClient
• Mailgun\Constants\Api
• Mailgun\Constants\ExceptionMessages
• Mailgun\Mailgun::$resetClient
• Mailgun\Mailgun::sendMessage()
• Mailgun\Mailgun::verifyWebhookSignature()
• Mailgun\Mailgun::post()
• Mailgun\Mailgun::get()
• Mailgun\Mailgun::delete()
• Mailgun\Mailgun::put()
• Mailgun\Mailgun::setApiVersion()
• Mailgun\Mailgun::setSslEnabled()
• Mailgun\Mailgun::MessageBuilder()
• Mailgun\Mailgun::OptInHandler()
• Mailgun\Mailgun::BatchMessage()

• Bug fixes with multiple recipients, inline images and attachments.
• Added more tests
• Using PSR-2 code style

• Require php-http/message (#142)
• Declare BatchMessage::endpointUrl (#112)

• Strict comparison of hash (#117)
• No dependency on Guzzle/PSR7 (#139)
• Build URL string form an array (#138)
• Docblock update (#134)
• Minor fixes (#90, #121, #98)

• Added webhook signature verification - (#50)
• Test PHP 5.6 and HHVM - (#51)
• Improved error handling - (#48)
• Fixed attachment handling in Message Builder - (#56)
• Allow any data type in custom data - (#57)
• Return non-JSON response data - (#60)
• Removed legacy closing braces - (#64)

• Improved security of OptInHandler - (#31)
• Fixed typo for including an Exception - (#41)
• Fixed Mocks, removed unnecessary code, applied styling - (#44 & #42)
• Less restrictive Guzzle requirement - (#45)

Enhancement:

• adjust file attachment/inline name (#21 @travelton)

Bugfixes:

• fixed issue with unordered route actions (#23 @travelton)

Enhancement:

• added ability to define non-https endpoint for debugging purposes (#23 @travelton)