reloopsh/be-contacts repository overview

⁠👥 Reloop — Contacts Service

The Contacts Service is the audience and contact management microservice in the Reloop⁠ platform. It handles the full lifecycle of contacts — including creating and managing contact records, custom properties, channel identifiers (email, phone, etc.), contact groups, and per-contact communication preferences.

Built on Bun⁠ + Elysia⁠, backed by PostgreSQL and Redis.

⁠🚀 Features

• Contact Management — Create, read, update, and delete contacts per organization
• Custom Properties — Define and assign custom fields to contacts
• Channel Management — Track multiple contact channels (email, phone, and more)
• Group Management — Organize contacts into groups for targeted campaigns
• Preferences — Manage per-contact communication preferences and opt-outs
• Organization-scoped — All data is isolated per organization
• API Key Auth — Secured via x-api-key header
• OpenAPI Docs — Auto-generated spec at /api/contacts/openapi
• NATS Bus — Event-driven integration via the Reloop message bus

⁠🔗 Quick Links

⁠⚡ Quick Start

docker pull reloopsh/be-contacts:latest

docker run -d \
  -p 8014:8014 \
  -e PG_URL=postgresql://user:password@host:5432/reloop \
  -e REDIS_URL=redis://:password@host:6379 \
  -e NATS_URL=nats://host:4222 \
  -e BASE_URL=https://your-domain.com \
  reloopsh/be-contacts:latest

The service will be available at http://localhost:8014/api/contacts.

⁠🔧 Environment Variables

⁠🛠 Tech Stack

• Runtime: Bun⁠
• Framework: Elysia⁠
• Database: PostgreSQL via Drizzle ORM⁠
• Cache: Redis
• Messaging: NATS

⁠📦 Part of the Reloop Platform

This image is one of several microservices that make up the Reloop backend. See the full list at hub.docker.com/u/reloopsh⁠.