De 1260 api mailing lists endpoint

src/Api/MailingList.php

@@ -15,6 +15,7 @@
 use Mailgun\Api\MailingList\Member;
 use Mailgun\Assert;
 use Mailgun\Model\EmailValidation\ValidateResponse;
+use Mailgun\Model\MailingList\BulkResponse;
 use Mailgun\Model\MailingList\CreateResponse;
 use Mailgun\Model\MailingList\DeleteResponse;
 use Mailgun\Model\MailingList\PagesResponse;
@@ -207,4 +208,59 @@ public function cancelValidation(string $address, array $requestHeaders = [])
 
         return $this->hydrateResponse($response, ValidationCancelResponse::class);
     }
+
+    /**
+     * Bulk upload members to a mailing list (JSON)
+     * @param string $mailList
+     * @param array $members
+     * @param bool $isUpsert
+     * @param array $requestHeaders
+     * @return BulkResponse
+     * @throws ClientExceptionInterface
+     */
+    public function bulkUploadJson(string $mailList, array $members, bool $isUpsert = false, array $requestHeaders = [])
+    {
+        Assert::stringNotEmpty($mailList);
+
+        $query = [
+            'members' => json_encode($members),
+            'upsert' => $isUpsert,
+        ];
+
+        $response = $this->httpPost(
+            sprintf('/v3/lists/%s/members.json?%s', $mailList, http_build_query($query)),
+            [],
+            $requestHeaders
+        );
+
+        return $this->hydrateResponse($response, BulkResponse::class);
+    }
+
+    /**
+     * Bulk upload members to a mailing list (CSV)
+     * //TODO
+     * @param string $mailList
+     * @param array $members
+     * @param bool $isUpsert
+     * @param array $requestHeaders
+     * @return BulkResponse
+     * @throws ClientExceptionInterface
+     */
+    public function bulkUploadCsv(string $mailList, array $members, bool $isUpsert = false, array $requestHeaders = [])
+    {
+        Assert::stringNotEmpty($mailList);
+
+        $payload = [
+            'members' => implode(",", $members),
+            'upsert' => $isUpsert ? 'true' : 'false'
+        ];
+
+        $response = $this->httpPost(
+            sprintf('/v3/lists/%s/members.csv', $mailList),
+            $payload,
+            $requestHeaders
+        );
+
+        return $this->hydrateResponse($response, BulkResponse::class);
+    }
 }

src/Model/MailingList/BulkResponse.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * Copyright (C) 2013 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Model\MailingList;
+
+use Mailgun\Model\ApiResponse;
+
+final class BulkResponse implements ApiResponse
+{
+    /**
+     * @var array|null
+     */
+    private $list;
+
+    /**
+     * @var string|null
+     */
+    private $message;
+    /**
+     * @var string|null
+     */
+    private $taskId;
+
+    public static function create(array $data): self
+    {
+        $model = new self();
+        $model->list = $data['list'] ?? null;
+        $model->message = $data['message'] ?? null;
+        $model->taskId = $data['task-id'] ?? null;
+
+        return $model;
+    }
+
+    /**
+     * @return array|null
+     */
+    public function getList(): ?array
+    {
+        return $this->list;
+    }
+
+    /**
+     * @return string|null
+     */
+    public function getMessage(): ?string
+    {
+        return $this->message;
+    }
+
+    /**
+     * @return string|null
+     */
+    public function getTaskId(): ?string
+    {
+        return $this->taskId;
+    }
+}