On this page

Elixir

Last updated July 22, 2026

Send vTilt events from any Elixir code by POSTing to the ingest API. Compatible with Phoenix, OTP releases, and stand-alone scripts.

There's no native Elixir SDK yet, but vTilt's wire format is a plain JSON POST so any Elixir code can emit events. Use this guide for non-Phoenix Elixir projects (OTP releases, scripts, Broadway pipelines). For Phoenix, see the dedicated Phoenix guide.

#1. Add dependencies

# mix.exs
defp deps do
  [
    {:req, "~> 0.5"},
    {:jason, "~> 1.4"},
  ]
end

elixir

# config/runtime.exs
config :my_app, :vtilt,
  token: System.fetch_env!("VTILT_TOKEN"),
  host: System.get_env("VTILT_HOST") || "https://www.vtilt.com"

elixir

#2. Capture module

# lib/my_app/vtilt.ex
defmodule MyApp.VTilt do
  require Logger

  @spec capture(String.t(), String.t(), map()) :: :ok
  def capture(distinct_id, event, properties \\ %{}) do
    cfg = Application.get_env(:my_app, :vtilt)

    Task.start(fn ->
      result = Req.post(
        cfg[:host] <> "/api/e",
        json: %{
          api_key: cfg[:token],
          event: event,
          distinct_id: distinct_id,
          properties: properties
        },
        receive_timeout: 2_000
      )

      case result do
        {:ok, _} -> :ok
        {:error, e} -> Logger.warning("vtilt capture failed: #{inspect(e)}")
      end
    end)

    :ok
  end

  def identify(distinct_id, properties) do
    capture(distinct_id, "$identify", %{"$set" => properties})
  end
end

elixir

#3. Capture events

MyApp.VTilt.identify("user_42", %{email: "alice@example.com", plan: "pro"})

MyApp.VTilt.capture("user_42", "purchase_completed", %{amount: 99.99, currency: "USD"})

elixir

#4. Broadway pipeline (recommended)

For high-throughput pipelines, batch captures through a Broadway producer to avoid hammering vTilt with individual requests.

defmodule MyApp.VTiltPipeline do
  use Broadway

  def handle_message(_, %Broadway.Message{data: {distinct_id, event, props}} = msg, _ctx) do
    MyApp.VTilt.capture(distinct_id, event, props)
    msg
  end
end

elixir

#Next steps

Phoenix integration guide — Phoenix-specific helpers + LiveView bridge.
Identify & alias — full identification model.
Event forwarding — fan events out to GA4, Meta CAPI, PostHog.
Common mistakes — integration pitfalls to avoid before you ship.

On this page

Elixir

Last updated July 22, 2026

Send vTilt events from any Elixir code by POSTing to the ingest API. Compatible with Phoenix, OTP releases, and stand-alone scripts.

#1. Add dependencies

# mix.exs
defp deps do
  [
    {:req, "~> 0.5"},
    {:jason, "~> 1.4"},
  ]
end

elixir

# config/runtime.exs
config :my_app, :vtilt,
  token: System.fetch_env!("VTILT_TOKEN"),
  host: System.get_env("VTILT_HOST") || "https://www.vtilt.com"

elixir

#2. Capture module

# lib/my_app/vtilt.ex
defmodule MyApp.VTilt do
  require Logger

  @spec capture(String.t(), String.t(), map()) :: :ok
  def capture(distinct_id, event, properties \\ %{}) do
    cfg = Application.get_env(:my_app, :vtilt)

    Task.start(fn ->
      result = Req.post(
        cfg[:host] <> "/api/e",
        json: %{
          api_key: cfg[:token],
          event: event,
          distinct_id: distinct_id,
          properties: properties
        },
        receive_timeout: 2_000
      )

      case result do
        {:ok, _} -> :ok
        {:error, e} -> Logger.warning("vtilt capture failed: #{inspect(e)}")
      end
    end)

    :ok
  end

  def identify(distinct_id, properties) do
    capture(distinct_id, "$identify", %{"$set" => properties})
  end
end

elixir

#3. Capture events

MyApp.VTilt.identify("user_42", %{email: "alice@example.com", plan: "pro"})

MyApp.VTilt.capture("user_42", "purchase_completed", %{amount: 99.99, currency: "USD"})

elixir

#4. Broadway pipeline (recommended)

For high-throughput pipelines, batch captures through a Broadway producer to avoid hammering vTilt with individual requests.

defmodule MyApp.VTiltPipeline do
  use Broadway

  def handle_message(_, %Broadway.Message{data: {distinct_id, event, props}} = msg, _ctx) do
    MyApp.VTilt.capture(distinct_id, event, props)
    msg
  end
end

elixir

#Next steps

Phoenix integration guide — Phoenix-specific helpers + LiveView bridge.
Identify & alias — full identification model.
Event forwarding — fan events out to GA4, Meta CAPI, PostHog.
Common mistakes — integration pitfalls to avoid before you ship.