Ruby SDK

Installation

Add the gem to your Gemfile:

bundle add loops_sdk

Or install it directly:

gem install loops_sdk

Want your coding agent to help with Loops? Install the Loops CLI and skills with one command:

curl -fsSL https://install.loops.so/wizard | sh

You will need a Loops API key to use the SDK. In your Loops account, go to the API Settings page and click Generate key. Copy this key and save it in your application code (for example in an environment variable).

Usage

Configure the SDK in an initializer:

config/initializers/loops.rb

require "loops_sdk"

LoopsSdk.configure do |config|
  config.api_key = ENV["LOOPS_API_KEY"]
end

Then call SDK methods in your application:

begin
  response = LoopsSdk::Contacts.create(
    email: "test@example.com",
    properties: { firstName: "John" }
  )
rescue LoopsSdk::APIError => e
  puts "Loops API Error: #{e.json['message']} (Status: #{e.statusCode})"
end

See the SDK docs for every method, rate limiting, and error handling. See the API documentation to learn more about rate limiting and error handling.

RubyGems

View the gem on RubyGems.

GitHub

View the documentation and source code.

Loops API

Read the Loops API reference.

Last modified on June 23, 2026

Learn

API

CLI

Guides

Installation

Usage

RubyGems

GitHub

Loops API

​Installation

​Usage

RubyGems

GitHub

Loops API

Installation

Usage