add multiple recipients functions

Author: kelostrada

lib/sendgrid/marketing_campaigns/contacts/lists.ex

@@ -62,6 +62,22 @@ defmodule SendGrid.Contacts.Lists do
     end
   end
 
+  @doc """
+  Adds a recipient to an email list.
+
+      :ok = add_recipient(123, "recipient_id")
+
+  """
+  @spec add_multiple_recipients(integer, [String.t()]) :: :ok | :error
+  def add_multiple_recipients(list_id, recipient_ids) when is_list(recipient_ids) do
+    url = @base_api_url <> "/#{list_id}/recipients"
+
+    case SendGrid.post(url, recipient_ids) do
+      {:ok, %{status_code: 201}} -> :ok
+      _ -> :error
+    end
+  end
+
   @doc """
   Deletes a recipient from an email list.
 

lib/sendgrid/marketing_campaigns/contacts/recipients.ex

@@ -24,6 +24,39 @@ defmodule SendGrid.Contacts.Recipients do
     |> handle_recipient_result
   end
 
+  @doc """
+  Adds or updates multiple recipients in contacts list.
+  Recipients param must be in format required by Sendgrid:
+    [
+      %{
+        "email" => "[email protected]",
+        "name"  => "John Doe",
+        etc...
+      }
+    ]
+  """
+  @spec add_multiple([]) :: { :ok, [] } | { :ok, String.t } | { :error, list(String.t) }
+  def add_multiple(recipients) when is_list(recipients) do
+    SendGrid.patch(@base_api_url, recipients)
+    |> handle_recipient_result
+  end
+
+  @doc """
+  Allows you to perform a search on all of your Marketing Campaigns recipients
+
+      {:ok, recipients} = search(%{"first_name" => "test"})
+  """
+  @spec search(map) :: { :ok, list(map) } | { :error, list(String.t) }
+  def search(opts) do
+    query = URI.encode_query(opts)
+    SendGrid.get("#{@base_api_url}/search?#{query}")
+    |> handle_search_result
+  end
+
+  # Handles the result when there are multiple persisted recipients.
+  defp handle_recipient_result({:ok, %{body: %{"persisted_recipients" => recipients}}}) when is_list(recipients) and length(recipients) > 1 do
+    { :ok, recipients }
+  end
   # Handles the result when errors are present.
   defp handle_recipient_result({:ok, %{body: body = %{"error_count" => count}}}) when count > 0 do
     errors =