lib/active_campaign/list.ex

defmodule ActiveCampaign.List do
  @moduledoc """
  Documentation for `ActiveCampaign.List`.
  """

  alias ActiveCampaign.Http

  @doc """
  Create a list

  ## Examples

      iex> ActiveCampaign.List.create(%{
        name: "Name of List",
        stringid: "Name-of-list",
        sender_url: "http://activecampaign.com",
        sender_reminder: "You are receiving this email as you subscribed to a newsletter when making an order on our site.",
        send_last_broadcast: 0,
        carboncopy: "",
        subscription_notify: "",
        unsubscription_notify: "",
        user: 1
      })
      {:ok, %{"list" => %{...}}}
  """
  @spec create(map()) :: {:ok, map()} | {:error, any()}
  def create(list) do
    Http.post("lists", %{list: list})
  end

  @doc """
  Retrieve a list

  ## Examples

      iex> ActiveCampaign.List.get(1)
      {:ok, %{"list" => %{...}}}
  """
  @spec get(integer()) :: {:ok, map()} | {:error, any()}
  def get(id) do
    Http.get("lists/#{id}")
  end

  @doc """
  Delete a list
  """
  @spec delete(integer()) :: {:ok, map()} | {:error, any()}
  def delete(id) do
    Http.delete("lists/#{id}")
  end

  @doc """
  Retrieve all lists

  ## Examples

      iex> ActiveCampaign.List.list()
      {:ok, %{"lists" => []}}
  """
  @spec list :: {:ok, map()} | {:error, any()}
  def list do
    Http.get("lists")
  end

  @doc """
  Create a list group permission

  ## Examples

      iex> ActiveCampaign.List.create_list_group_permission(%{
        listid: 1,
        groupid: 1
      })
      {:ok, %{...}}
  """
  @spec create_list_group_permission(map()) :: {:ok, map()} | {:error, any()}
  def create_list_group_permission(list_group) do
    Http.post("listGroups", %{"listGroup" => list_group})
  end
end